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は じ め に 


デザ イナ ー ツ ー ル と し て の Flash、RIA イ ン フ ラ と し て の Flex と いう カテ ゴリ が よく 説明 され 
て いた 状況 は Adobe Flash Platform の 登場 に より 、 そ の ルー ツ を 同じ くす る も の と し て 統一 
され まし た 。Adobe が プロ モー ト す る Flash Platform は ツー ル や プラ ッ ト フ ォ ー ム 、 開 発 イ 
ン フ ラ と いう 提供 する 側 だ け で な く 、 ビ ジネス パー トナ ー や ユー ザコ ミュ ニテ ィ を 含む エコ シ 
ステ ム と いう 壮大 な 構想 を 持っ て いま す 。 目指 す も の は Web、 デ スク トッ プ 、 モ バイ ル を は じ 
め と する あら ゆる メデ ィ ア へ の Flash テ クノ ロジ ー の 浸透 で す 。 


本 書 で 解説 する ActionScript3.0 Flash API は 、Flash Platform の 心臓 部 で ある Flash Player 
が 提供 する API に 直接 アク セス し 、 も っ と も 効率 よく 稼動 させ る 手段 で す 。 本 書 で は 、 そ の 主 
な 機能 を ジャ ン ル 別に 分 類 し 、 サ ンプ ルコ ー ド と 共に 解説 し ます 。 


Flash Player10 で 実現 され る 強力 な 機能 と し て は 、3D 操 作 、 高 度 な テキ スト レイ アウ ト な ど 
が 筆頭 に 挙げ られ ます 。3D 操 作 に 関し て は 、 難 解 な 座標 に 関す る 数 学 処理 を いっ さい 理解 する 
必要 な し に 高度 な 3D 処 理 を 追加 で きま す 。 高度 な テキ スト レイ アウ ト と は 、25 年 の 歴史 を 持つ 
Adobe の タイ ポ グ ラフ ィ テ クノ ロジ ー が Flash Player に 融合 され た も の で 、Flash Platform が 
サポ ー ト する メデ ィ ア に 印刷 品質 と 同等 の パブ リッ シン グ を 提供 する も の で す 。 流 し 込ま れ た 
テキ スト (フロ ー) に 対す る 複数 コラ ム 、 双 方 向 文字 、 縦 書き 文字 、 そ の 他 の 高度 な 制御 を 提供 
し ます 。 


Flash Platform の 統一 に より も た ら さ れる Flash コ ー ダ ー へ の も う 1 つ の アド バン テー ジ は 、 
Flash Builder と いう プロ グラ ム 開 発 統合 環境 と の 融合 が 行わ れ た こと で す 。Flash Builder は 
Flex 開 発 ツ ー ル で ある Flex Builder の 最新 バー ジョ ン で す が 、 本 書 で 解説 する よう に 、Flash 
CS5 プ ロジ ェクト を 作成 編集 、 デ バッ グ 、ActionScript プ ロジ ェクト の 作成 と デバ ッ グ が 可能 
と な っ て お り 、ActionScript を 駆使 する Flash コ ー ダ ー の 開発 効率 を 向上 させ る こと が 強く 期 
待 で きま す 。 


ペー ジ 数 な どの 都合 に より 、 最 新 の Flash API が 持つ すべ て の 技術 要素 を 解説 する こと は で 
きま せん が 、 も っ と も ベー ス と な る 概念 と 使用 すべ き ク ラス と その メソ ッ ド 、 ブ プロパ ティ に つ 
いて 、 で きる だ け 多 く 掲 載 し まし た 。 全 体 を 通し て お 読み いただく か 、 開 発 の 傍ら に 置か れ 、 
Flash API の 本 質 を 理解 され 、Adobe が 提供 する プラ ッ ト フ ォ ー ム を 使用 し て 、 ど れ だ け 高 度 
な パフ ォ ー マ ンス を 実現 で きる か も ご 理解 いた だ けれ ば 幸い で す 。 


2010 年 6 月 
品田 亮 


eoNBi3Nl: 


PART 1 
た etga ド (dl り ジ 4 ウル テ ガ プ ガ 4 ヨリ オリ ドミ シド 


g 較 ActionScript コ ー ド の 記述 2 
1-1-1 ActionScript バ ー ジ ョ ン と Flash Player、AVM の 互換 性 を 確認 する 2 

1-1-2 ActionScript コ ー ド の 作成 、 編 集 と 保存 4 

6 

7 





1-1-3 ActionScript プ ログ ラム に コメ ント を 書く 
1-1-4 ActionScript の 値 表 現 ( リ テラ ル ) を 理解 する 


Kg 取 】 変 数 を 使う 10 
1-2-1 変数 の 宣言 と デー タ 型 10 
1-2-2 変数 の デフ ォ ル ト 値 を 使う 12 
1-2-3 定数 を 宣言 し て 使う 14 

E 民 演算 子 を 使う 13 
1-3-1 演算 子 の 種類 と 優先 順位 を 理解 し て 使う 15 
1-3-2 演算 子 の 結合 規則 を 理解 し て 使う 16 

gg 了 4 条 件 分 岐 を 行う 17 
1-4-1 条件 に よっ て 異な る 処理 を 行う 17 
1-4-2 複数 の 条件 を 効率 よく 処理 する (switch) 18 

EK 皿 ヨ 繰り 返し 処理 を 行う 20 
1-5-1 条件 を 指定 し て 繰り 返し 処理 を 行う (while) 20 
1-5-2 回 数 を 指定 し て 処理 を 繰り 返し 実行 する (for) 2 1 
1-5-3 オブ ジェ クト 内 の プロ パテ ィ 名 を 取り 出す (for...in ) 23 
1-5-4 XML や オブ ジェ クト 内 の プロ パテ ィ 値 を 取り 出す (for each...in) 25 

E 衣 関数 を 使う 27 
1-6-1 関数 を 作成 する 27 
1-6-2 関数 に パラ メー タ を 渡す 28 
1-6-3 関数 か ら の 戻り 値 を 利用 する 29 
1-6-4 関数 の バラ メー タ 数 を 可変 に する (.. rest) 31 

gg 取 】 エ ラー 処理 を 行う 32 
1-7-1 エラ ー が 発生 し た 時 の 処理 を 行う 32 

g 世 カ イベ ント の 処理 を 行う 34 
1-8-1 イベ ント リス ナー を 作成 する 34 


1-8-2 イベ ント オブ ジェ クト を 利用 する 36 


II 


CONTENTS 


g 区 』】 ク ラス と イン スタ ンス 39 
1-9-1 クラ ス を 宣言 する 39 
1-9-2 クラ ス を 使う 40 
1-9-3 クラ ス の プロ バテ ィ と メソ ッ ド を 作成 する 42 
1-9-4 クラ ス を 拡張 し て 新しい クラ ス を 作成 する 44 
1-9-5 パッ ケー ジ を 理解 し て 使う 46 


PART 2 


日 付 ・ 時 間 処 理 














P 語 日 付 と 時 刻 50 
2-1-1 Date オ ブ ジ ェクト を 作成 する 5 0 
2-1-2 現在 の 日 付 と 時 刻 を 取得 する 5 2 
2-1-3 日付 / 時 刻 の 演算 を 行う 5 4 

ル 冨 】 タイ マー と 経過 時 間 57 
2-2-1 時 間 を 計測 する 5 7 
2-2-2 タイ マー を 使用 し て 繰り 返し 処理 を 行う 59 

PART 3 

数 値 と 数 学 処理 

EK 有 数 値 の 処理 62 
3-1-1 数 値 デ ー タ を 使う 62 
3-1-2 数 値 を 指定 の 書式 に 変換 する 63 
3-1-3 数 学 的 な 演算 を 行う 65 
3-1-4 ラン ダム な 数 値 を 生成 する 67 
3-1-5 四捨五入 や 小数 の 切り 捨て 、 切 り 上 げ を 行う 68 

PARI 4 

KA ペク ルン ん mm 

Pl 配 列 yg 
4-1-1 イン デック ス 配 列 を 使う 72 
4-1-2 結合 配列 を 使う 75 
4-1-3 配列 に フィ ルター を か ける 76 
4-1-4 Dictionary に よる 結合 配列 を 使う 78 

受 】 ベ クタ ー 79 
4-2-1 ベク ター を 使う 79 
4-2-2 ベク ター の 要素 を フィ ルター する 8 1 


4-2-3 ベク ター の 要素 を ソー ト す る 8 3 


CONTENTS 


PART 5 
テキ スト で 正規 表現 処理 








E 昌 』 ス トリ ング デー タ の 処理 86 
5-1-1 スト リン グ オ ブ ジ ェクト (String) を 使う 86 
5-1-2 スト リン グ か ら 一 部 の 文字 列 を 取り 出す 88 
5-1-3 スト リン グ 中 の 文字 列 を 検索 する 89 
5-1-4 スト リン グ 中 の 文字 列 を 置換 する 90 
5-1-5 大 文字 / 小 文字 の 変換 を 行う 92 
5-1-6 URL エン コー ド / デ コー ド を 行う 93 

E 遇 4 正 規 表現 94 
5-2-1 正規 表現 で 行え る こと を 把握 する 94 
5-2-2 大 本 的 な 正規 表現 を 行う 95 
5-2-3 文字 を 検索 する (メタ 文字 と フラ グ ) 27 
5-2-4 数 字 を 検索 する (メタ シー ケン ス ) 101 
5-2-5 電話 番号 や メー ル ア ド レス の フォ ー マ ッ トチ ェ ッ ク を 行う 104 

E 設 # ラ テキスト フ ィ ー ル ド 106 
5-3-1 テキ スト フィ ー ル ド の 種類 と クラ ス を 把握 する 106 
5-3-2 テキ スト フィ ー ル ド オ ブ ジ ェクト を 使う 108 
5-3-3 入力 用 の テキ スト フィ ー ル ド を 作る 111 
5-3-4 テキ スト 入力 フィ ー ル ド に 入力 で きる 文字 を 制限 する 113 
5-3-5 ActionScript で テキ スト の フォ ー マ ッ ト を 設定 する 15 
5-3-6 HTML テ キス ト を 表示 する 118 
5-3-7 HTML テ キス ト の ハル ハイ パー リン ク で イベ ント を 発生 させ る 120 
5-3-8 CSS を 使用 し て テキ スト を フォ ー マ ッ ト す る 122 
5-3-9 ユー ザ 環 境 の フォ ント 情報 を 調べ る 127 
5-3-10 IME の 有効 無効 を 調べ て オン / オ フ 、 変 換 モ ー ド を 制御 する 129 

PARI 6 
高度 な テキ スト 処理 

K 高 Text Layout Framework (TLF) 132 
6-1-1 FTE と TLF 132 
6-1-2 TLF マ ー ク アッ プ 言 語 を 使う 140 
6-1-3 TLF ク ラス を 使う 145 
6-1-4 TLF エ レ メ ン ト の スタ イル 設定 を 行う 152 


PART / 


ビジ ュ ユア ル エ レ メ ン フント の 操作 


k 誤 』 ス テー ジ と タイ ムラ イン 168 
7-1-1 Stage オ ブ ジ ェクト を 使う 168 








7-1-2 実行 時 に フレ ー ム レー ト を 変更 する 
7-1-3 ステ ー ジ の 拡大 / 縮 小 モ ー ド を 変更 する 
7-1-4 フル スク リー ン モ ー ド を 使う 


用 】 表 示 オ ブ ジ ェクト (DisplayObject) 
7-2-1 表示 オブ ジェ クト (DisplayObject オ ブ ジ ェクト ) を 使う 
7-2-2 表示 オブ ジェ クト の 位置 と サイ ズ 変 更 、 回 転 


CONTENTS 


170 
17 1 
174 


の ます 


だ ョ 
183 


7-2-3 表示 オブ ジェ クト の 透明 度 、 マ スク 、 ブ レン ドモ ー ド 、 描 画 を 調整 する 186 


7-2-4 表示 オブ ジェ クト の 9 スラ イス 


イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 
7-3-1 イン タラ クティ ブ オ ブ ジ ェクト の イベ ント と プロ パティ を 使う 
7-3-2 マウ スイ ベン ト を 処理 する 
7-3-3 キー ボー ドイ ベン ト を 処理 する 
7-3-4 特殊 キー の 入力 を 処理 する 
7-3-5 Tab に よる フォ ー カ ス 移 動 を 制 件 する 


FocusManager 
7-4-1 FocusManager を 使う 
7-4-2 Enter キ ー に 反応 する デフ ォ ル ト ボ タン を 作成 する 


MovieClip 
7-5-1 MovieClip を 使う 
7-5-2 MovieClip の 再生 と 停止 を 行う 
7-5-3 MovieClip の フレ ー ム と シー ン 情 報 を 得る 
7-5-4 ライ ブラ リシン ボル の イン スタ ンス を ステ ー ジ に 配置 する 


E 訪 4 外部 SWF の ロー ド 
7-6-1 Loader ク ラス を 使う 
7-6-2 外部 SVWF フ ァイル を ロー ド す る 
7-6-3 SWF ファ イル の 読み 込み 情報 を 調べ る 
モー ショ ント ゥ イー ン 
7-7-1 Motion ク ラス を 使う 
7-7-2 モー ショ ント ゥ イー ン ア ニメーション を 行う 
7-7-3 モー ショ ント ゥ イー ン で フィ ルター アニ メー ショ ン を 作成 する 
gk 訪 IK (イン バー ス ・ キ ネ マ ティ ックス ) 
7-8-1 fl.ik バ パッケージ を 使う 
7-8-2 ActionScript で アー マチ ュ ア を 動か す 
7-8-3 IKEvent を 使う 
k 含 】 ジ オメ トリ に よる 2 次 元 操作 
7-9-1 2 次 元 の 平面 座標 で の オブ ジェ クト 操作 を サポ ー ト する クラ ス 
7-9-2 Rectangle ク ラス を 使う 
7-9-3 Matrix ク ラス で 移動 、 回 転 、 拡 大 / 縮 小 を 行う 
MaLU3D 


7-10-1 3D 関 連 機能 を サポ ー ト する クラ ス 





19 1 


も ケ さき 
19 3 
194 
198 
e01 
604 


e08 
Z08 
e12 
e14 


e14 
の ます 
619 
1 


625 
の る う 
628 
633 
の あず 
637 
240 
643 
247 
247 
65Z 
258 
e6 1 
e6 1 
664 
e68 
675 
キー 


CONTENTS 


7-10-2 PerspectiveProjection オ ブ ジ ェクト で 遠近 法 を 使う 
7-10-3 Matrix3D オ ブ ジ ェクト を 使う 


PART 8 


プラ ノイ リッ クス フィ ル タ ダー 





E 語 』 ビ ッ ト マ ッ プ 
8-1-1 ビッ トマ ッ プ を ロー ド し て 表示 する 
8-1-2 ビッ トマ ッ プ の ロー ド 状 況 を 調べ る 
8-1-3 ライ ブラ リ の イメ ー ジ を 表示 する 
8-1-4 BitmapData を 使う 
8-1-5 ビ ピット マップ イメ ー ジ を コピ ー す る 
8-1-6 表示 オブ ジェ クト を ビッ トマ ッ プ イメ ー ジ 上 に 描画 する 


E 影 4 フィ ルター 
8-2-1 フィ ルター オブ ジェ クト を 作成 し て 表示 オブ ジェ クト に 適用 する 
8-2-2 フィ ルター を BitmapData オ ブ ジ ェクト に 適用 する 
E 朗 # グ ラフ ィ ッ ク 措 画 
8-3-1 グラ フィ ッ ク 描 画 APl を 使う 
8-3-2 線 と 塗り を 定義 する 
8-3-3 線 と 曲線 を 描画 する 
8-3-4 グラ デー ショ ン の 描画 を 行う 


PART 9 


と 4 記 コ キル 

サウ ンド 
2-1-1 サワ ンド ファ イル を ロー ド す る 
9-1-2 Sound イ ベン ト を 処理 する 


9-1-3 埋め 込み サウ ンド を 処理 する 
9-1-4 サワ ンド の 再生 と 停止 、 ボ リュ ー ム と パン を 制御 する 


E 受 】 マ イク 
9-2-1 マイ ク を 使用 する 

EE ヒデ テ ォ 
9-3-1 FLVPlayback コ ン ボ ポー ネン ト で ビデ オ を 再生 する 
9-3-2 ActionScript で リモ ー ト ビデ オ 再 生 を 行う 








クラ ス 別 INDEX 


Z81 


686 


と 94 
eZ94 
2Z98 
303 
308 
ひみ.3 3 
に 光 委 』 


320 
320 
324 
328 


328 
うき う 
ゆす 
339 


344 
344 
350 
354 
356 
359 
うう ツ 


36 3 


363 
367/ 


378 


stionScript コ ー ド の 





1 - 1 ActionScript コ ー ド の 記述 
た alt に (dg リャ A セ ニン レイ ココ FE 





PART 


Player、 AVM の 互換 性 を 確認 する 


Flash の スク リプ ト 言 語 と し て 進化 し て きた ActionScript で す が 、Version3.0 で は 本 格 的 な 
オブ ジェ クト 指向 に 基づく コー ディ ング が で きる よう に な り ま し た 。 ま た 実行 環境 で ある Flash 
Player 内 の AVM (ActionScript Virtual Machine) も バー ジョ ン が 上 が り (AVM2)、 パ フォ 
ー マ ン ス が 大 幅 に 改善 され て いま す 。ActionScript3.0 で プロ グラ ミン グ を 行う 人 は 、 旧 バー 
ジョ ン の ActionScript お よび AVM の 組み 合わ せ に より どの よう な 機能 が サポ ー ト され る か を 
把握 し て お く 必 要 が あり ます 。 新規 に Flash ア プリ ケー ショ ン を 作成 する 際 に は 、 パ ブリ ッシュ 
を ActionScript3.0 で 行う か 、ActionScript2.0 で 行う か を 選択 し ます 。ActionScript2.0 を 選 
択 し た 場合 、ActionScript3.0 の API を 使用 する コー ド を 記述 する と コン バイ ル エ ラー に な り ま 
す 。 た だ し この 設定 は 固定 的 な も の で は な く 、 パ ブリ ッシュ 設定 の スク リプ ト を Action 
Script3.0 に 変更 する こと で 解決 で きま す 。 


田 バブ リッ シュ 設 








記 D) ーーーーーーーーーーーーーーーーーーーー | 


Fash ドキ ュ メン ドウ ィ ン ドウ で 新しい FLA ファ イル て . 骨 ) を 作成 し ま | 
す 。 パブ リッ シュ 診 定 が ActionScript す 。 

Player 用 に パブ リッ シュ する SWF ファ イ ル の ッ テ ィ ア と 構造 を 訟 定 
する に は 、 FLA ファ イル を 使用 し ます 。 



















新規 ドキ ュ メ ント の 作成 時 に パブ リッ 
シュ する ActionScript バ ー ジ ョ ン を 指 
定 す る 






Adobe Device Centra 
電 ActionScript 3.0 カラス 
| ActionSgript 3.0 イン ター フェ イス 
や | ActonSript (AS) ファ イル 

| AS 玉 ュ ニケ ーション ファ イル 

守 Fash JavaScript ファ イル 

で Flash ブロ ジェ カト 







OTNY 


SG 


現在 の プロ ファ イル : | デフ ォ ル ト *| 出 』*| 9 | 





較 導 reh 細 | 
PlayeP |Flssh Player10 。 < 博幸 





対象 と する Flash Player と ActionScript バ ー 






画像 と サウ ン 





JPEG 画質 (Q) : UM ドリ ジン ョ ヨン は パブ リッ ン ュ 設 定 で 変更 可能 

『 | JPEG の 非 ブロ ッ カ ( 化 を 有効 に する 

オー ディ オス トリ ー ム (③) : MP3. 16 kbps. モノ ラル | 論 定 。 」 

オー ディ オイ ベン ト E) : MP3. 16 kbps. モノ ラル . 論 定 。. 
『 | 個々 の サウ ンド 訟 定 を 無効 に する 
『 | デバ イス サウ ンド の 書き 出し 

SWF 訟 定 ー 

I ピ | ムー ビー の 圧縮 








1-1-1 
ActionScript バ ー ジ ョ ン と Flash Player、 AVM の 互換 性 を 確認 する 


邊 Flash Player に 含ま れる AVM バー ジョ ン と 実行 可能 ActionScript バ ー ジ ョ ン 


息 ActionScript3.0 と Flash Player10 に 関す る 互換 情報 















Flash Player の 旧 バ ー ジ ョ | Flash Player は バー ジョ ン ア ッ プ の 際 に 常に 旧 バ ー ジ ョ ン と の 互換 性 を 
ン 用 に 書か れ た アプ リ ケ ー | 維持 し ます 。 そ の た め 、Flash Player10 よ り 以 前 に 作成 され て 実行 され 
ショ ン の 実行 て いる SWF は Flash Player10 で ロー ド 可 能 で す 。 


ActionScript バ ー ジ ョ ン の | ActionScript2.0 で 作成 し た アプ リケーション に ActionScript3.0 コ ー ド 
混在 を 追加 する こと は で きま せん 。 つ まり 、1 つ の アプ リケーション (SWF) 
内 で ActionScript1.0/2.0 と ActionScript3.0 コ ー ド は 混在 で きま せん 。 


。 ActionScript3.0 で 書か れ た アプ リケーション は ActionScript1.0/2.0 で 
0 ドジ fb02Hー 書か れ た SWF を ロー ド で きま す が 、 内 部 の 関数 / 変 数 に は アク セス で き 
ませ ん 。ActionScript1.0/2.0 で 書か れ た アプ リケーション は Action 

Script3.0 の SWF を ロー ド で きま せん 。 





乱 ActionScript と Flash Lite の バー ジョ ン 
バー ジョ ン 


ActionScript3.0 | AVM2 上 で 、 以 前 の バー ジョ ン に 比べ て 高速 に 実行 され ます 。 オ ブ ジ ェクト 指向 
プロ グラ ミン グ の 理解 が 必要 に な り ま す 。ECMAScript 仕 様 に 完全 に 準拠 し て い 
ます 。ActionScript3.0 を 使用 する FLA フ ァイル に は 、 以 前 の バー ジョ ン の Acti 
onScript を 含め る こと が で きま せん 。 


ActionScript2.0 | ActionScript3.0 よ り 簡 単に 学習 で き 、 使 用 する こと が で きま す 。 コ ン パ イル され 
た コー ド は 、ActionScript 3.0 で 書か れ た コー ド よ り Flash Player 上 で の 実行 速 
度 は 遅く な り ま す が 、 コ ンピュータ に 負荷 が か か ら な い 種 類 の プロ ジェ クト で は 
ActionScript2.0 の ほう が 有利 に な る 場合 が あり ます 。ActionScript 2.0 は ECMA 


Script 仕様 に 基づい て いま す が 、 完 全 に 準拠 し て いる わけ で は あり ませ ん 。 


ActionScript1.0 | ActionScript の も っ と も 簡単 な 形式 で あり 、Flash Lite プ レー ヤー の 一 部 の バー 
ジョ ン で 引き 続き 使用 され て いま す 。ActionScript1.0 お よび 2.0 は 、 同 じ FLA 
ファ イル に 共存 で きま す 。 


Flash Lite 2.x 携帯 電話 お よび モバ イル デバ イス で 実行 され て いる Flash Lite 2.x に より サポ ー ト 
され る ActionScript 2.0 の サブ セッ ト で す 。 


Flash Lite 1.x 携帯 電話 お よび モバ イル デバ イス で 実行 され て いる Flash Lite 1.x に より サポ ー ト 
され る ActionScript1.0 の サブ セッ ト で す 。 





PART 


2 ActionScript コ ー ド の 
作成 、 編 集 と 保存 





ActionScript コ ー ド を 作成 、 編 集 す る た め の ア ド ビ 製 品 に は 、Flash Professional な どの 
Flash オ ー サ リン グ ツ ー ル と Flash Builder が あり ます 。Flash オ ー サ リン グ ツ ー ル を 使用 する 
場合 、 フ レー ム ア ク ショ ン は アク ショ ン バ パネル 、 外 部 カス タム クラ ス フ ァ イル や ドキ ュ メ ント 
クラ ス フ ァ イル の 編集 は スク リプ トウ ィ ン ド ウ で 行い ます 。 ア クシ ョ ン パ ネル [ウィ ンド ウ ] - 
[アク ショ ン ] また は F9 で 開き 、 ス クリ プ ト ウ ィ ン ド ウ は 、 人 外部 as ファ イル を 開く と 開始 し ます 。 
Flash Builder で は 、ActionScript プ ロジ ェクト と Flash CS5 プ ロジ ェクト を 作成 し て 編集 する 
こと が で きま す 。ActionScript プ ロジ ェクト は Flash API を 使用 し て SWF を 構築 する た め の プ 
ロジ ェクト で す が 、Flash オ ー サ リン グ ツ ー ル の よう に ステ ー ジ の ビジ ュ ア ル 編 集 は で きま せ 
ん 。Flash プ ロジ ェクト で は 、Flash CS5 で 作成 され た FLA フ ァイル や XFL フ ァイル を 開い て デ 
バッ グ し た り 、Flash Builder か ら Flash Professional を 起動 し て パブ リッ シュ し た り 、Flash 
Professional の デバッガ を 起動 する こと が で きま す 。 
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半 Flash Builder に よる ActionScript プロ ジェ クト の 編集 
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1- 1 -2 
ActionScript コー ド の 作成 、 編 集 と 保存 


oe 





lmpprl flash.dlsplay.Spritei 
public class MI extends Sprite 


ラン シン 


ic デイ トー 統 in() 


ー だ する アデ メー ジラ ファ デア 
yo wl :8Lrime・ ト ee GIF“: 
プ / 
Ya obj il tap8ampleClaesA = new BItmapSampleClassA(url): 
ン 開 ソス トム た 用 恋 
addOhild(obj ): 


0 


import (1 BOB ・ PerepectiveProjection: 
we flas 


・Poln 
POrt 計 =0 eXt 。 TextFlsld 


ie Class _3D8ampleli を tea Sprite { 
private yar xdiinti 


Private war yd:lnti 
private war zdiinti 


Flash 関連 ツー ル ボ タン 


前 ーー 0.8 ): 
は (0。 -50。 100, 100): 

dth/2: 

srysstage.stagellel 2: oe 

7 さと dg で が / プ の ィ 

も = ne す TextField(): 

t .text 信 06 

も 。X = 100: t.y = 100: 

addChild(【 

942VLI9KANer Eye -・ENTER FRAME , onEnterframs ) : 


} 
public functien setX(xiint)ivoid 【 
this.Xd = xi 


ィ 3Ze さめ 767 の 7) 


public fumction setY(yiint):ygid 【 





at に (du ジル = レ ルケ メ パ ピ 
= と. タン スエ ネ < 





PART ActionScript プ ロ グラ ム 中 に コメ ント を 書く こと が で きま す 。 コ メン ト は プロ グラ ム と し て 

処理 され な い テ キス ト で す 。 具体 的 に は 変数 の 用 途 や 処理 の 概要 な どの メモ 書き を プロ グラ ム 
中 に 書い て お くも の で す 。 コ メン ト を 残し て お く と 他人 が プロ グラ ム を 理解 する と き に も 役 立 
ち ま す 。 








ActionScriDt の コメ ント 。。0。0000000 


1 行 コ メン ト / (スラ ッシュ ) を 2 つ 続 け て 書き ます 。 そ れ よ り 後 る の 文 | // コメ ント テキ スト 
は 行 の 終わ り ま で が コメ ント に な り ま す 。 








で てい 








| 複数 行 コ メン ト / (スラ ッシュ ) と * (アス タリ スク ) を 組み 人 台 わ せ て 書き ま | /* コメ ント テキ スト 
す 。 開始 部 分 は 「/」、 終 了 部 分 は !*/ 」 で 書き ます 。 開 | ... 
始 部 分 と 終了 部 分 の 間 が コメ ント に な り 、 複 数 行 の コメ * / 
ント を 書く こと が で きま す 。 














= ます %1 下 本 m5】 粒 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ActionScript プ ブログ ラム 中 の コメ ント 文 BasicSampieA.ila 
/ 


クラ ス の 概要 : こ の クラ ス は グラ フィ ッ ク 負 理 を 行う サン プル で す 。 





コン スト ラク タ : 細 を と り ま せん lis 
package { 
// 必要 な パッ ケー ジ を イン ポー ト す る の 1 行 コ メン ト 
1mDport fF]ash.d1Ssplay .Shape : 
1mport Flash.disp1ay.Sprite: // Sprite ク ラス を 使用 し ます 一 一 ②③1 行 コメ ント 


pub1ic cl]ass test Graphics extends Sprite 1 
pub1ioc funotion tegt Graphicg ( ) ( 
va rect :Shape = new Shape() : 
rect .draph1Cg .bed1nF1il1( OxFFEFEFCC ): 
this .addCh11d( rect ): 


① が /#* */ に よる 複数 行 コ メン ト で す 。 こ の 例 で は 、 ク ラス の 概要 を 記述 し て いま す 。⑫ と 
3) に 1 行 コ メン ト が あり ます 。3③ の よう に 、1 行 コメ ント は プロ グラ ム 文 の 後ろ に 記述 し て その 
6 文 の 説明 書き と する 場合 が 多い で す 。 


4 ActionScript の 値 表 現 ( リ テラ ル ) を 
理 角 す る 





プロ グラ ム 中 の 値 の 書き 方 は 、 リ テラ ル (Literal) と 呼ば れ ま す 。 例 えば 半角 で 「1」 と 書く と 、 


ActionScript コ ン バ パイ ラー は 整数 の 1 と 解釈 し ます 。 こ れ は 整数 リテラ ル と 呼ば れ ま す 。「 "1"」 
と 書く と スト リン グ (String) の "1" と 解釈 され ます 。 ま た 、ActionScript で は 、XML リ テラ 
ル に より 、 プ ログ ラム 中 に 直接 XML デー タ を コー ディ ング で きま す 。 よ く 使 用 する リテラ ル を 
ご 紹介 し ます 。 


スト リン グリ テラ ル 

ActionScript で は 、"( 二 重 引 用 符 ) か ' (一 重 引 用 待 ) で テキ スト を 囲む の こと で スト リン グ 値 
を 表記 で きま す 。 ス トリ ング は 一 連 の 文字 、 数 値 そ の 他 の 文字 を まとめ て 1 つの 値 と し て 扱う 
た め の も の で す 。 


trace("T!m a 1]oser" ): 


trace('This is A Strinq' ) : 


1 行 目 で は 、" ( 二 重 引用 符 )、2 行 目 で は ' (一 重 引用 符 ) で 囲む の ス トリ ング 値 を 作成 し て trace 
出力 し て いま す 。 


> 実行 結果 
T!m a 1O8er 


This ig A Srinq 


数 値 リ テラ テル 
ActionScript で は 、 プ ログ ラム 中 に 書か れ た 数 値 は 整数 (int また は uint) また は Number 
型 の 値 と し て 解釈 され ます 。 小 数 つき の 数 値 は Number 型 に な り ま す 。 


trace( 100 18 int ): 


traCe( 3.14 18 Number ): 
1 行 目 で は 100 と いう int 値 を 、2 行 目 で は 3.14 と いう Number 値 を 書い て いま す 。 
ァ 実行 結果 


七 了 UG 


TUG 


1 - 1 
AtionScript コー ド の 記述 


XML リテラ ル 
ActionScript で は 、XML を スト リン グ と し て 書く 必要 は な く 、 直 接 プ ログ ラム 中 に 値 と し て 
書く こと が で きま す 。 
PART 
Ya エ myXML,:XML」 = 
<DFOQuC キ > 
<1tem 1d='001!> 
<menuName > 上 OrO</menuName> 
<D1Ce>19 .99</D エ 1Ce> 
</ 1t 上 em> 
</ DrOQUuC> 
traoe ( myXML .toStrinqd() ): 


2 行 目 か ら 7 行 目 で 書か れ た XML は 1 行 目 で 宣言 され た 変数 myXML に 代入 され ます 。 


ぁ 実行 結果 
_ <Pproduc> 
<1tem 1d="001"> 
<menuName > 上 Oo< /menuName> 
<D エ 1Ce>19 . 99< /D エ 1C@e> 
</ 1 上 em> 


</proQduC キ > 
配列 リテラ ル 
角 か っ こ 「[] 」 の 中 に 「,」 (カン マ ) を 区 切り 文字 と し て 使用 し て 配列 を 書く こと が で きま す 。 


Var a1:Array = [ a, D, 2 ]: 


Trace ( a1 ): 
1 行 目 で 3 つの 要素 か ら な る 配列 を 作成 し て 、 宣 言 さ れ た 変数 a1 に 代入 し ます 。 


> 実行 結果 


る 。D。 る 


オブ ジェ フト リテラ ル 
中 か っ こ 「 { } 」 の 中 に キー と 値 の ペア を 「,」 (カン マ ) を 区 切り 文字 と し て 使用 し て Object イ 


1-1-4 
ActionScript の 値 表 現 ( リ テラ ル ) を 理解 する 


ンス タン ス を 書く こと が で きま す 。 こ の よう な イン スタ ンス は 結合 配列 と も 呼ば れ ます 。 





name、gender と いう 2 つの プロ パテ ィ を 持つ Object イ ンス タン ス を 作成 し 、 宣 言 さ れ た 
person 変 数 に 代入 し ます 。 





ぁ 実行 結果 


PART 


10 





ActionScript3.0 で は 、 変 数 は 必ず var ス テー トメ ント を 使用 し て 定義 し ます 。 変 数 に 格納 す 
る デー タ の 種類 は デー タ 型 で 表し ます 。ActionScript で は 、 デ ー タ 型 の 宣言 は 必須 で は あり ま 
せん が 、 使 用 が 推奨 され ます 。 デ ー タ 型 は 、 変 数 名 の 後ろ に : (コロ ン ) を つけ て 指定 し ます 。 
例え ば true / false 値 を 扱う た め の 変 数 は Boolean (ブー リア ン ) 型 、 日 付 テ データ を 処理 する と 
き は Date (デー ト ) 型 の 変数 を 宣言 し ます 。 デ ー タ 型 は 、 格 納 す る 値 に より プリ ミ テ ィ ブ フ 型 と 
複合 型 に 分 けら れ ま す 。ActionScript の 変数 名 に 使用 で きる 文字 は 下記 の よう に 決ま っ て いま 
す 。 ま た 、 変 数 名 の 大 文字 と 小文字 は 別 の も の と し て 区 別 さ れ ま す 。 例 えば 、myName と 
MyName は 別 の 変数 と な り ま す 。 


ActionScript の 変数 宣言 は 、var の 後に 変数 名 (variableName)、 続 け て : (コロ ン ) の 後に 
デー タ 型 (dataType) を 書き ます 。 


Ya ゞ ariabl]eName : dataTYDe 


ActionScript の 変数 名 と し て 使用 で きる 文字 (下記 の 文字 を 組み 合わ せ て 変数 名 を 定義 で き 
ます ) 


・a-z の 英文 字 

・A-Z の 英文 字 

・0-9 の 数 字 ( 数 字 は 変数 名 の 先頭 に は で きま せん ) 
湯 


プリ ミ テ ィ ブ デー タダ 型 

プリ ミ テ ィ ブ デー タ 型 は Boolean、int、Number、String、uint な どの 「 プ リ ミ テ ィ ブ 値 」 
と 呼ば れる 基本 的 な デー タ 型 で す 。 プ リ ミ テ ィ ブ デ ー タ 型 の 変数 に は 、 単 一 つの プリ ミ テ ィ ブ 値 
を 格納 で きま す 。 


VAY 1 エ :1m も 
1 = 0: 


raCe( + ): 


int 型 の 変数 i を 宣言 し てこ 0 と いう プリ ミ テ ィ ブ 値 を 代 人 し ます 。 


すご 革 1 
変数 の 宣言 と デー タ 型 


で ぶ ーー 

台 デ テー タ 型 

複合 型 は プリ ミ テ ィ ブ 値 以外 の 値 を 格納 する デー タ 型 で 、 複 数 の 値 を セッ ト と し て 格納 し ま 
す 。Array、Date、Error、Function、RegExp、XML、XMLList、Object な どの ActionSc 
ript コ アク ラス は 代表 的 な 複合 デー タ 型 に な り ま す 。 





Object 型 の 変数 o を 宣言 し て 、name と gender と いう プロ パテ ィ を 設定 し ます 。 こ の 操作 
に より 、o は 2 つの プロ バテ ィ を 持つ 「 複 合 デ ー タ 」 に な り ま す 。 複合 デー タ の 場合 、trace() で 
直接 出力 する と 下記 の よう な 結果 に な り ま す 。 





ぁ 実行 結果 





11 


変数 の デフ ォ ル ト 値 を 使う 





PART ActionScript で は デー タ 型 の 種類 に よっ て 変数 の デフ ォ ル ト 値 が 決ま っ て いま す 。 テ フォ ル 
ト 値 は 、 変数 を 宣言 する と 自動 的 に 設定 され る 値 で す 。 


和 ActionScript の デー タ 型 と デフ ォ ル ト 値 









































デー タ 型 (日 本 語 読 み ) 層 要 デフ ォ ル ト 値 
Boolean (ブー リ リア ソ ) true / false の 2 値 を 格納 で きま す 。Boolean 型 の 変数 は 、| false 

| f 文 の 判定 に も 使用 で き ます 。 
int (イン ト ) 整数 値 を 格納 で きま す 。 ActionScript で は 32 ピ ッ ト を | 0 





使用 する た め 、-2? 2?!-1 の 範囲 が 有効 で す 。 こ の 範 | 
囲 を 超え る 数 値 を 扱う 場合 、 Number 型 を 使用 し ます 。 


| Number (ナン バー) | 加 数 と 小数 つき の 数 値 を 格納 で きま す 。64 ビ ッ ト が 使用 | NaN 
され ます 。 値 の 範囲 は 、 

NumberlMAX_VALUE 

NumberiMIN_VALUE で 調べ る こと が で きま す 。 



































ニーーーーーーーーーーーー イ ーー ーーーーーー 

















| String (スト リン グ ) 文字 列 を 格納 する デー タ 型 で す 。 UTF-16 形 式 の Uni | null 
code 文 字 コ ー ド で 格納 され ます 。 
是 
uint (ユー イン ト ) | (プラ ス ) の 整数 値 を 格納 で きま す 。 int 型 と 異な り 、 マ |0 


イナ ス 値 を 扱え ませ ん が 、 範 囲 が 約 2 倍 に な り ま す 。0 
> 2?-]1 の 範囲 に 使用 で きま す 。uint の u は 、unsigned 
(符号 な し ) を 意味 し ます 。 














ーー 


ャ 一 
Object (オブ ジェ クト ) ActionScript ク ラス 階 層 の ルー トク ラス で す 。 つま り 、| null 
すべ て の クラ ス の 基本 クラ ス に な り ま す 。 






























































ActionScript ク ラス ActionScript API で 提供 され る クラ ス や ユー ザ 定 義 ク ラ | null 
ユー ザ 定 義 ク ラス | ス を 使用 する 場合 、 変 数 を 宣言 し て イン スタ ンス を 生成 
し ます 。 
* (デフォルト) 変数 の 型 指定 が な い 場 合 、 デ フォ ルト の デー タ 型 を 表す | undefined 
* に な り ま す 。 
※ NaN は 「Not A Number」 で 、IEEE-754 で 規定 され て いる 数 値 で は な いこ と を 表す 特別 な 値 
で す 。 


※ undefined は [初期 化 さ れ て いな い 、 型 指定 の な い 変 数 ] や 初期 化 さ れ て いな い ダ イナ ミッ 
クオ ブ ジ ェクト の プロ パテ ィ に 設定 され る 特殊 な 値 で す 。 

※ 上 記 以 外 に null 値 だ け で 構成 され る Null デ ー タ 型 や undefined 値 だ け で 構成 され る void デ ー タ 
到 U が あり ます 。null は 「 値 を 設定 し て いな い | と いう こと を 表す 特殊 な デー タ 型 で 、 関 数 の 戻 
り 値 と し て 「 返 す デ ギー タ が な い | こと を 示す た め に も 使用 され ます 。void は 関数 の 宣言 で 、 値 
を 返さ な いこ と を 示し ます 。 
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| 
変数 の デフ ォ ル ト 値 を 使う 


= た | 衣 画 コ 直 mlp】 ヨ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


BasicSanminieB.fla 


Var D:Boo」ean : 一 - 
ざ aY 1:1n 七 
Va mi:NumDer 』 


Var 8:Sr1nd 





Va U1:Uu1n : 
Var O:Ob]ec 』 


Var d:Date: 





写 村 が DGG まう ーー デー 





trace( "b5="+b ): 
上 raCe( "1=" + ュ ): 
tracCe( "nm=" + ロロ ): 


race( "8=" + 8 ): 





“ 「 ー- ② 変 数 の 値 を trace() 出力 
EraCe( "u1 ユ = リ + M1 ): 


trace( "Oo=" + よ つ 〇 ): 
trace( "ds=m+d ): 


trace ( "undef=" + undef ): 


が 変数 の 宣言 で す 。?② で 、 宣 言 し た 変数 の 値 を trace() 出 力 し ます 。 そ れ ぞ れ の 変数 に は 値 
を 代入 し て いな いた め 、 テ フォル ト 値 が 出力 され ます 。 


ぁ 実行 結果 
b=false 


ュ =0 
n=NaN 
8=mul 1 
u1 ユ =0 
〇 =mu 1 
d=nmu」 1 


undef=undaef ined 


PART 
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例え ば 円 周 率 を よく 使用 する アプ リケーション の 場合 、 計 算 す る 場所 で 3.14 と いう 数 値 リ テ 
ラル を 使用 する より も 、3.14 と いう 値 を 持つ 変数 を 作成 し て お いた ほうが 効率 の 良い コー ティ 
ング が 行え ます 。 こ の 場合 、 そ の 変数 は 固定 値 を 持つ 特殊 な 変数 と し て 作成 し ます 。 こ の よう 
な 変数 は 定数 と 呼ば れ ま す 。 

ActionScript の 定数 宣言 は 、const の 後に 定数 名 (CONSTANT_NAME)、 続 け て : (コロ ン ) 
の 後に デー タ 型 (dataType) を 書き 、 値 を 代入 し ます 。 値 は ブロ グラ ム 中 で 変更 する こと は で 
きま せん 。 定 数 は 慣習 的 に 大 文字 アル ファ ベッ ト と 数 値 を 使用 し 、 単 語 の 区 切り を (アン ダー 
スコ ア ) で つない で 構成 し ます が 、 こ れ は 定数 名 を 見 て その 内 容 が わか る た め 効 率 的 で す 。 こ 
の 命名 方 法 は 必須 で は あり ませ ん 。 ま た 、AvctionScript に は 、 シ ステ ム で 定義 ご され て いる 定数 
が あり 、 プ ログ ラム で 自由 に 参照 で きま す 。 こ の 定数 は グロ ー バ ル 定 数 と 呼ば れ ま す 。 


ActionScript の 定数 宣言 


Const CONSTANT NAME:QdataTyDe = Va1lue: 


AMPLE C ロ DE 国 EE 



































BaSiCSanipie も .fla 
CO きも 、 財 下 下 00 の w 93.39 > ーーーーーーーーーーーーーーーーーーーー 用 た 電導 を 
だ 合 直す を 所 陣 を な 党 2 の イーーーーーーーー デ ーーーーー ゆら こと で 使用 し て で 時短 
Var u8d1 :NumDe ィ = 1039.99: 
き ActionScript3.0 ジロ ー バ ル 定 数 
定数 定義 内 容 
伯 人 My : Number 正 の Infinity を 表す 特殊 な 値 で す 。 
-Infinity : Number | 負 の Infinity を 表す 特殊 な 値 で す 。 
NaN : Number | " 非 数 " (NaN) の 値 を 表す Number デー タ 型 の 特殊 メン バー で す 。 
undefined : * | 初期 化 され て いな い 型 指定 の な い 変 数 、 ま た は 初期 化 さ れ て いな い ダ イナ ミッ 
クオ ブ ジ ェクト プロ パテ ィ に 適用 され る 特殊 な 値 で す 。 














1 - 3 演算 子 を 使う 
深 算 子 の 種類 と 優先 順位 を 


理解 し て 使う 


数 値 演 算 、 代 入 、 大 小判 定 、 論 理 判定 な ど 、 プ ログ ラミ ング 中 で 行う 演算 は 、 演 算 子 を 使用 
し て 行い ます 。 演算 子 は オペ レー タ (Operator) が 原語 で 、 演 算 の 対象 は オペ ベラ ンド (Operan 
d) と 呼ば れ ま す 。 例 えば 1 + 2 と いう 演算 の 場合 、 洒 算 子 は |+」 で 、「1」 と 「2」 の 数 値 リ テラ 
ル が オペ ラン ド に な り ま す 。ActionScript で は 、 リ テラ ル 、 変 数 、 式 を オペ ラン ド と し て 記述 
で きま す 。 


物 ActionScript の デー タ 型 と デフ ォ ル ト 値 


演算 子 の 種類 | 含ま れる 演算 子 


[| tx:y] 0 f) new x.y xIyI 





演算 子 の 種類 含ま れる 演算 子 


ビッ ト 単 位 の 論理 積 | & 

































<></> @ :: (AND) 
| me 
X 二 十 Xー ビッ ト 単 位 の 排他 的 
議 理 和 (XOR) 


二 士 X --X + - - ! delete 
typeof void 










ビッ ト 単 位 の 議 理 和 
(OR) 


| 
論理 積 (AND) 
















































本 論理 和 (OR) 
ビッ ト 単 位 くく >> >>> 
シフ ト 楽 件 
関係 碗 小 聞 過 攻 玩 義和 代入 *ー /= 96 = ニオ = -= <<= 
inStanceof jS >> ニ >>> ニ & 三 ^= |= 
ガマ 

















※ 表 の 上 に あ る 演算 子 ほど 優先 順位 が 高く な り ま す 。 


らら AMPLE ヒロ ロ E EE 


Va +1:1n 革 = TO: 


Va 8Um: 1 ロ 七 = ユ ++ + 5: 


X=y+2*z: と いう 演算 式 の よう に 1 つの 式 に 複数 の 演算 子 が 使用 され る 場合 、 左 か ら 順 に 
演算 を 行っ て ゆく と 、x = の 代入 を 行う と き に = の 右側 の 演算 が 行わ れ て いな いこ と に な り 、 
演算 が 行え ませ ん 。 実際 に は 、= の 優先 順位 が 低い た め 、 + と * の 演算 が 最初 に 行わ れ ま す 。 
ActionScript で は 、 演 算 子 に 優先 順位 を つけ て 感覚 的 に も 矛盾 が 生じ な い プ ログ ラミ ング が で 
きる よう に な っ て いま す 。 サ ンプ ブル コ ー ド の 2 行 目 の 演算 で は 、++ 後 置 演算 子 と + 演算 子 が 使 
用 され て いま す が 、++ 演 算 子 の 優先 順位 が 高い た め 、sum:int = 11 + 5: と 同じ 処理 内 容 に な 
り ま す 。 
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2 演算 子 の 結合 規則 を 理解 し て 使う 





PART 優先 順位 の み で は 解決 で き な い 問題 が あり ます 。 同 じ 順 位 の 演算 子 が 1 つの 式 で 使用 され た 

場合 で す 。 例え ば 、x = y + f) - 1: は y + f0) と 、f() - 1 の どちら が 最初 に 行わ れる か と いう こ 
と が 決ま っ て いな いと 、 正 し い プ ログ ラミ ング が で きま せん 。 こ の 問題 は 結合 規則 で 解決 され 
ます 。AvctionScript で は 、 代 入 演算 子 と 柔 件 演算 子 に つい て は 、 そ の 右側 か ら ( こ れ を 右 結合 
と 呼び ます )、 そ れ 以 外 の 演算 子 に つい て は 左 か ら 演 算 が 行わ れる (これ を 左 結合 と 呼び ます ) 
よう に 決め て お り 、 演 算 の 実行 順序 が 明確 に 決定 され ます 。 


= 宮下 5 首 m】 ヨ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


VaY 1 エ 1:1mt = 10: 
Va 大 :1m も = ュ エミ = ミュ 1: 


tracCe( KK ): 


2 行 目 で 1 つの 演算 式 に = 演算 子 が 2 回 使用 され て いま す 。= 演算 子 は 右 結合 で ある た め 、 次 
の 順序 で 計算 が 行わ れ ま す 。 


まあ - 林 ネ 
⑧) ]:1 も 軸 も = ま 


> 実行 結末 


1 
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1 - 4 条件 分 岐 を 行う 
条件 に よっ て 異な る 処理 を 行う 





条件 分 岐 は 、 プ ログ ラム 実行 中 に 値 の 判定 を 行い 、 処 理 を 分 岐 する 構文 で す 。 例 えば | 読み 
込む ビデ オ の サイ ズ に よっ て 表示 する 位置 を 変更 する ] と いう よう な 処理 を 行う 場合 、 柔 件 分 
岐 が 必要 に な り ま す 。 も っ と も 基本 的 な 閉 件 分 岐 は 、if .. else で す 。 if 文 の 構文 は 、if の 後ろ に 
( ) を 書き 、 そ の 中 に 条件 分 岐 の 基準 と な る 半 件 (Condition) を 書き ます 。 炒 件 は true / false 
で 判定 で きる 必要 が あり ます 。else を 使用 し て 、 系 件 の 値 が false の と き に 行う 負 理 を 書く こと 
が で きま す 。 条件 に は 、 変 数 、 式 、 リ テラ ル を 書く こと が で きま す 。 


if .… else 文 の 構文 
if ( Condit1on ) 
( 
// condition が true の 場合 の 処理 
) 
else if ( oondiEion2 ) ( 
( 
/ / condition2 が true の 場合 の 処理 
) 
.。。 // こ こ に 別 の e1se if ( ) { ! を 書い て 条件 を 追加 で きま す 
( 


// condition2 が fa1] se の 場合 の 処理 


※ .… の 部 分 に 複数 の else if 句 を 記述 で きま す 。 
※ else if、else の 使用 は オプ ショ ン で す 。 処理 が 不要 の 場合 、 書 く 必 要 は あり ませ ん 。 


AMPLE ヒロ ロ E EE 


BasicSaftpleD.fHa 


Va 1:Number = 10.1: 
も 二 E ) 


YaCe ( "1 は nt 型 で す 。: " + ュ ): 
186e 


trace(" 1 は int 型 で は あり ませ ん 。: "+ ォ ュ )』 


4 - 。 複数 の 条件 を 効率 よく 処理 する 


(switch) 





PART if..else 構 文 を 使用 し て 複数 の 馬 件 分 岐 を 行え ます が 、 条 件 が 多い 場合 、switch を 使用 し た ほ 
う が 便 利 で す 。switch に 使用 する 柔 件 式 は 必ず し も true / false を 返す 必要 も あり ませ ん 。 
switch 文 の 構文 は 、switch の 後ろ に ( ) を 書き 、 そ の 中 に 半 件 分 岐 の 基準 と な る 条件 (condition) 
を 書き ます 。 灯 件 は 、 働 意 の 式 が 使用 で きま す 。 式 が 返す 値 を case 句 で 判定 し て 分 岐 処理 を 行 

いま す 。 


switch 文 の 構文 
gw1tch ( Condition ) 


( 


Ca8eG VaLUG1 : 
// condition が va1ue1 を 返す 場合 の 処理 


DrG8 み Kk : 


Ca8eG Va1UG2 : 
// condition が va1ue2 を 返す 場合 の 処理 


DrGaK : 


QdefFau」 二 : 
// conditionmn が すべ て の case に 該当 し な い 場 合 の 処理 
DreaKk : 


※ default の 使用 は オプ ショ ン で す 。 処 理 が 不要 の 場合 、 書 く 必 要 は あり ませ ん . 


= 中 コ 画 = 首 mmp】 ヨ 粒 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


シン ブル な switch 文 BasicSampnleE.fa 








YA BB@&BOn SE エ 1n9 = "大 『: ーーーーーーー ー ピ ーーー -① 
8w1tCh ( 8eagon ) 

Ca8e 『 春 ": 

trace ( 『" 瞬 が か いで すね " ): ーーー⑨ こ の 文 が 実行 され る 





Drea み K : 
Ca8e 『『: 
traCe ( 『 署 いで すね ) : 


D エ GaKk : 


1 
複数 の 柔 件 を 効率 よく 処理 する (switch) 


caSe 『 秋 『 す : 
trace ( "涼し いで すね ): 
DreaK: 


WW 。 
ご 8 ーー 4 


trace ( 『 守 い で すね )』 


break : 
も っ と も シン プル な switch 文 の 例 で す 。 ① で 宣言 し た 変数 season に 格納 され て いる 文字 列 
を 判定 し て 分 岐 し ます 。 サ ンプ ル の 場合 、" 春 " と いう 値 な の で 、⑧⑫ が 実行 され ます 。 


AMPLE ヒロ ロ ロ E EE 


break を 利用 し た 高度 な switch 文 BasicSampleFfla 





いま 40 本 いい x ュ か 1 っ 寺 ecaopcgisoooxuaarar ① 
8Sw1tch ( 8Core ) 
( 
Ca8e 10: 
CaASe 9: 
Yace ( "と て も 『" ): 
Ca8@e 8: 
CaS8e 7/: 
trace ( "良い 点数 で す 。" ): ーーーーーーーーーー ②⑫) 


的 お 導 八 > ー デ ーーー…ーー ペ ーー 





@ 


Ca8e 5: 
trace( "いち お う " ): 
Ca8e 6: 
trace( "合格 で す 。" ): 
breaKk : 
defaul : 
trace ( 『 不 合格 で す 。" ): 


breaKk : 


で 作成 し た 変数 score の 値 を switch 文 で 判定 し て いま す 。10、9 の と き は 、「 と て も 」 と 表 
示し ます が 、break が な いた め 、 そ の まま ②⑫ を 実行 し て ③ の break で switch を 終了 し ます 。5 
の と きも 同様 の 処理 を 行い ます 。 こ の よう に 、break を うま く 使 用 し て 高度 な 件 分 岐 処 理 を 
行う こと が で きま す 。 19 


1 - 5 繰り 返し 処理 を 行う 
抄 件 を 指定 し て 繰り 返し 処理 を 行う 


(while) 





PART while 文 を 使用 する と 、 あ る 式 の 値 が true の 間 、 処 理 を 繰り 返す こと が で きま す 。while 文 は 、 
繰り 返し の 回 数 が 明確 に 決ま ら な いと き な ど に 使用 され ます 。 例 えば 「 あ る 文章 の 中 か ら 指 定 
し た 文字 列 の 出現 回 数 を カウ ント する 」 と いう よう な 処理 に は while 文 の 使用 が 適し て いま す 。 
while 文 の 構文 は 、while の 後ろ に ( ) を 書き 、 そ の 中 に 繰り 返し の 基準 と な る 条件 (condition) 
を 書き ます 。 件 は true / false で 判定 で きる 必要 が あり 、 和 件 が true の 間 、while 以 下 の ブ 
ロッ ク を 繰り 返し 実行 し ます 。 


while 文 の 構文 


while ( ConmQdition ) 


/ / condition が て true の 間 繰 り 返 す 処 理 


RE 
文字 列 の 出現 回 数 を 調べ る BitmapSarmmples.fla 

Var 8:SEtr1nqg = "while 文 を 使用 する と 、 あ る 式 の 値 が true の 間 、 処 理 を 繰り 返す こと が で きま す 。 

whi]e 文 は 、 繰 り 返 し の 回 数 が 明確 に 決ま ら な いと き な ど に 使用 され ます 。" : 

Var arqet : S 上 r1nqd = "while": // 出 現 回 数 を 調べ る 文字 列 

Va と 8 も ar:1mE = 0: 

Va で CH も : 基 IE = 0: 

Star ヒ = 8.1ndexOf ( target, star ): 

wh1]e {( 8EarE != -1 ) 

( 

8tar ヒ 上 = 8.1ndexOf ( target, gtart + 1 ): 


Cn ヒ 二 二 


) 


trace ( tarqdet + " は 『"+ cnmt + "『 個 あ り ま す 。" ): 


String.indexOf( val:String, startIndex:Number = 0):int メソ ッ ド は 、var で 指定 し た 文 
字 列 を 、String 文 字 列 の startIndex で 指定 され た 文字 位置 か ら 検索 し て 見 つか っ た 位置 を 返し 
ます 。 見 つか ら な い 場 合 、 一 1 を 返し ます 。 こ の メソ ッ ド を 利用 し て target に 設定 し た 文字 列 
の 出現 回 数 を カウ ント し て いま す 。 


と 0 


2 回 数 を 指定 し て 処理 を 繰り 返し 
実行 する (for) 





配列 の 要素 の よう に 、 あ ら か じ め 個 数 (/ ル ー プ する 回 数 ) が わか る 場合 、for 文 に よる 繰り 返 。 s 
し 処理 を 行い ます 。for 文 で は 、 繰 り 返 し 回 数 の カウ ンタ と し て 利用 する int 型 の 変数 を 使っ て 
処理 を 行い ます 。for 文 の 構文 は 、for の 後ろ に ( ) を 書き 、 そ の 中 に : (コロ ン ) で 区 切ら れ た 3 
つの 部 分 を 書き ます 。3 つ の 部 分 に は 、 そ れ ぞ れ ① 繰 り 返 し 前 に 1 回 行う 処理 (init)、⑧ 繰 り 返 
し の 継続 条件 (condition)、③ 繰 り 返 し ご と に 行う 処理 (next) を 書き ます 。 


for 文 の 構文 
For ( ①⑪①1init : ⑧condition : ③mnext ) 


( 


/ / 繰り 返し 行う 処理 


※ 繰り 返し 行う 処理 が 1 行 の 場合 、 ブ ロッ ク を 示す | | は 人 省略 で きま す 。 


AMPLE ヒロ ロ E ERREEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


シン フル な for 


a 了 1 :1 抽 七 


fOY ( まま = O : エエ <= 10 : ユエ ++ ) raoe( 3 ): 


も っ と も シン プル な 例 で す 。for ( ) の 中 で 、 ま ず ル ー プ を 開始 する 前 に ① i = 0 を 実行 し ま 
す 。 そ の 後 、⑧ 条 件 で ある i <= 10 を 満た す (true) 間 、3 行 目 か ら 5 行 目 の ブ ロッ ク 内 に 書か 
れ た 処理 を 実行 し ます 。1 回 ルー プ す る ご と に ③ i++ を 行う た め 、10 回 処理 を 繰り 返す と i の 値 
は 11 に な り 、⑧ の 条件 が false に な り 、 繰 り 返 し 処理 は 終了 し ます 。 


AMPLE ビ ロ ロ E EE 


配列 内 の 要素 を すべ て 調べ る BasicSanminleH.jla 
var pref:Array = [ "北海 道 ", "東京 都 ", 『 神 奈川 県 ", "福岡 県 " ]: 
yar 1:int: ①String 配列 の 要素 を 作成 





FEOY ( = 0O : も < PE、LerG も tb / 6+ ) 


gwitch ( preE[ 1 ] ) 一 一 一 一 一 一 ーーー 一 ーーーーーーーーーーーー ③Switch 文 で String 値 の 判定 


Ca8e 『 北 海道" : 


②for 文 で ① の String 配列 の 要素 を チェ ッ ク 


g1 


PART 


の 2 


1 -5 


繰り 返し 処理 を 行う 


traoce( pref[ 1 ] + 『: 北 海道 地方 で す " ): 





break : 

Ca8e "東京 都 " : 一 

case 『 神 奈川 県 " | 3 RT ④case 文 を 連続 し て 複数 の 値 を まとめ て 処理 
スバ 1 で < 


trace( preE[ 1 ] + 『: 関 東 地方 で す 9 ): 


Dr てら 6aK : 


case 『 福 岡 県 : 
trace( prefF[ 1 ] + "『: 九 州 地方 で す " ): 


break : 


で 作成 し た String 配 列 の 要素 を ② の for 文 を 使用 し て 1 つ ず つ チ ェ ッ ク し ます 。 同様 の 処理 
は 配列 内 の 要素 を チェ ッ ク す る と き の テ クニ ッ ク と し て 使用 で きま す 。③ で は switch 文 で 
String 値 の 判定 を 行っ て いま す 。「 東 京都 また は 神奈 川 県 ] と いう よう に 、 い くつ か の 値 を ま と 
め て 処理 する に は 、(④ で 行っ て いる よう に case 文 を 連続 し て 書く こと で 行え ます 。 


> 実行 結果 
北海 道 : 北 海道 地方 で す 
東京 都 : 関 東 地方 で す 
神奈 川 県 : 関東 地方 で す 
福岡 県 : 九州 地方 で す 


5 アル シオ キャ ン 4 (ノア 4=『A と 克 を てこ 
取り 出す (for..…in) 





オブ ジェ クト に 動 的 に 追加 され た プロ バテ ィ 名 を 1 つ ず つ 〇 順番 に 取得 し た い 場 合 、for..…in に 5 
よる 繰り 返し 処理 で すべ て の プロ パテ ィ 名 を 取り 出す こと が で きま す 。 for.…in 句 は 配列 の 要素 
取得 に も 使用 で きま す 。 for ..in 句 の 構文 は 、for の 後ろ に ( ) を 書き 、 そ の 中 に プロ パテ ィ 名 
を 格納 する 変数 (propName) と 、 対 象 の オブ ジェ クト (targetObject) を 指定 し ます 。 す べ て 
の プロ パテ ィ に つい て 繰り 返し 処理 が 行わ れ 、 ル ー プ ご と に 変数 に プロ バテ ィ 名 が 格納 され ま 
す 。 


for ..…in 句 の 構文 


For ( Yar ProOpName : S 上 r1nd 1n tarqgetOb]ect ) 


( 
// 各 プ ロ パ ティ 名 ご と に 行う 処理 


AMPLE ピロ DE 5 


Object オ ブ ジ ェクト 内 の プロ パテ ィ と その 値 を すべ て 取り 出す BasicSamplelfla 
var targetOb]ject :Ob]ect = { name: "Miyata", gender: "Male" 電 : 
① テ スト 用 の オブ ジェ クト を 作成 
For ( Yar prODertyName : St 上 r1nd 1n tarqetOb]ect ) 
1 ② プ ロ パ ティ 名 を 格納 する 変数 と 対象 の オブ ジェ クト を 指定 
trace ( "プロ パテ ィ 名 =" + propertyName + ", 値 =" + tarqgetOb]ect [ propertyName 
』): 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ーー プロ ザイ の 第 を 取り 出す 


) は テス ト 用 の オブ ジェ クト を 作成 し て いま す 。 オ ブ ジ ェクト 内 の プロ バテ ィ の 数 だ け 繰 り 
返し 処理 が 行わ れ 、②⑫ で 指定 し た propertyName:String 変 数 に その 名 前 が 格納 され ます 。③) 
で 行っ て いる よう に 、targetObject[ propertyName ] と いう 記述 で プロ バテ ィ の 値 を 取り 出 
すこ と が で きま す 。 


> 実行 結果 


プロ パテ ィ 名 =name , 値 =Miya 上 a 
プロ パテ ィ 名 =gender, 値 =Male 


っ 3 


1-$ 
繰り 返し 処理 を 行う 


= が % 画 コ 疾 呈 mp】 コ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


カス タム クラ ス 内 の プロ パテ ィ 名 と 値 を 取り 出す CustomCiass.as 





package { 
PART pub11c dynamio class CustomC1ass { 
“ pub11C Var myProperty : Strinq= "固定 プロ パテ ィ 『: 


BasicSampleJ.fla 


var tardetOb] ec : Cu8tomClas8 = new CustomCl]ass ( ) : 
tarqetOb]ect .mySt 上 rinq= "M1yaa" : 
tarqetOb]eCt . myTn キ =1 : 


for (Yar propertyName : Strinqg in targetOb]ect) { 
trace ( "プロ パテ ィ 名 =" + properEtyName + ", 値 =" + targetOb]jeoct [ 
PrOpertyName ] ): 


dynamic 指 定 さ れ た customClass に 動 的 に 追加 ご れ た myString、myInt プ ロ パ ティ の み が 
for..…in の 対象 と し て 出力 され ます 。 


実行 結果 


プロ パテ ィ 名 =myStrinq, 値 =M1iyaa 
プロ パテ ィ 名 =myTnt , 値 =1 


の 4 


dE 飼 (| ほこ レア ルン オン 4 [ノア 4=『A と て 
値 を 取り 出す (for each..…in) 





オブ ジェ クト 内 の プロ バテ ィ 値 を 1 つ す ずつ 順番 に 取得 し た い 場 合 、 個 数 と 順序 の 取得 が で き 5 
な いた め 、for 文 で 繰り 返し 処理 が で きま せん 。 こ の 場合 、for each..….in に よる 繰り 返し 処理 
で すべ て の プロ バテ ィ 名 を 取り 出す こと が で きま す 。 for each..…in 句 は XML 処理 の 機能 と し て 
導入 され まし た が 、XML の み で な く 、 配 列 の 要素 取得 に も 使用 で きま す 。for each...…in 句 の 構 
文 は 、for each の 後ろ に ( ) を 書き 、 そ の 中 に プロ パテ ィ 値 を 格納 する 変数 (propValue) と 、 
対象 の オブ ジェ クト (targetObject) を 指定 し ます 。 す べ て の プロ パテ ィ に つい て 繰り 返し 処 
理 が 行わ れ 、 ル ー プ ご と に 変数 に プロ パテ ィ 値 が 格納 され ます 。 


mm た つっ / まま て プア 
for each...jn 句 の 構 双 


( Yar propName : dataType jji targetOb]ect ) 


// プ ロ パ ティ 値 ご と に 行 つ 処理 


= 中 上 = 赴 中 mlp】 コ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


だ クト 内 の プロ / 値 を すべ て 取り 出す BasicSampleK.fla 


y す キー 
6」 っ の アン チ さと 


var targetOb]ject :Objeot = { name: "Miyata", gender: "Male" }): 一 一 
ジテ スト 用 の オプ ジェ 





クト を 作成 
( Ya DrODertyValue : S 上 1nd tarqdetOb]ect ) 
( ② の プロ パテ ィ 値 を 格納 する 変数 と 対象 の オブ ジェ クト を 指定 
trace ( "プロ バテ ィ 値 =" + propertyValue ): ーー ③ プ ロ パ ティ の 値 を 取り 出す 


は テス ト 用 の オブ ジェ クト を 作成 し て いま す 。 オ ブ ジ ェクト 内 の プロ パテ ィ の 数 だ け 繰 り 
返し 処理 が 行わ れ 、 2 で 指定 し た propertyValue 変 数 に その 値 が 格納 され ます 。 3 で プロ パ 
ティ の 値 を trace 出 力 し ます 。 


> 実行 結果 


プロ パテ ィ 値 =Ma1e 
プロ パテ ィ 値 =Miyata 


と 5 
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1-5 
繰り 返し 処理 を 行う 





ニア リン | ニ 】 敵 コ 首 mi mlp】 コ 
XML 内 の 繰り 返し 項目 を 1 つ ず つ 取 り 出 す 








XML リテラ ル で 作成 され た dataXML の 繰り 返し 要素 で ある productName を 処理 し ます 。 


実行 結果 





1 - 6 関数 を 使う 
1 関数 を 作成 する 





関数 は 、 繰 り 返 し 使用 で きる コー ドブ ロッ ク で す 。ActionScript プ ログ ラム で 複数 の 個所 で 
同じ 処理 を 行う よう な 場合 、 そ の 部 分 を 関数 に し て お く と 効率 が 良く な り ま す 。ActionScript 
で は 、 ク ラス 内 に 関数 を 定義 し た 場合 、 メ ソ ッ ド (method) と 呼び 、 そ れ 以 外 の 場所 で 定義 さ 
れ た 関数 は その まま 関数 (function) と 呼び ます 。 関 数 を 作成 する に は 、function キ ー ワ ー ド 
に 続け て 関数 名 を 書き ます 。 関 数 名 の 後ろ に ( ) を 書き 、 そ の 中 に その 関数 が 受け る パラ メー 
タ (param1,.…) を 書き ます 。 パ ラメ ー タ を 受け な い 場 合 、( ) 内 は 空白 に し ます 。 関数 の 戻り 
値 が ある 場合 、: に 続け こそ の デー タ 型 (returnType) を 書き ます 。 戻り 値 が な い 場 合 、: void 
と 記述 し ます 。 


関数 の 構文 


Funct1on EunoE1ionName ( [param1 : dataType, . . .paramN : dataType] ) 
reGtUTnTYVDGe 


/ / 関数 の 処理 


※[ ] は 必要 が な い 場 合 、 省 略 可 能 な こと を 意味 し ます 。 


※ param1:dataType,.…paramN:dataType は 1 つ 以 上 の パラ メー タ が 記述 で きる こと を 意味 し ます 。 


ね 記 貞 = 導 四 mlg】 間 ーーーーーーーーーーーーーーーーーーーーーーーーーーー 


シン ン フ ル な 関数 の 作成 と 呼び 出し BasicSampleM,fla 
Function simpleFunoction( ) :void 1 人 
tracCe( "simpleFunction ( ) が 実行 され まし た 。" ) : ① 
81mpleFunC1On ( ) : 一 ーー 一 ーーーーーーーーーーーーーーーーー ーーーーーーーーーーーーー- ②) 


り で 作成 し て いる simpleFunction 関 数 は パラ メー タ を 取ら ず 、 戻 り 値 を 返し ませ ん 。② で 
関数 の 呼び 出し を し て いま す 。 


> 実行 結果 


81mpleFunot1on ( ) が 実行 され まし た 。 


と / 


1 - 6- 2 関数 に パラ メー タ を 渡す 





。 関数 は パラ メー タ を 受け る こと で 、 固 定 的 な 処理 だ け で な く 動 的 な 機能 を 果たす こと が で き 
ます 。 定 義 し た 関数 の パラ メー タ は 、 そ の 関数 内 で の み 有 効 な 変数 と し て 機能 し ます 。 
「 関 数 を 作成 する 」 で 解説 し た よう に 、 関 数 が 受け る パラ メー タ は 関数 名 の 後ろ に ( ) を 
書き 、 そ の 中 に 受け る パラ メー タ (param1,.… ぼ ) を 書き ます 。 パ ラメ ー タ を 受け な い 場 合 、( ) 内 


は 空白 に し ます 。 
Function ] LionNan [param1 : dataTyDe, . . .」 : returnTyDe 
( 
/ / param1 , . .. を 変数 と し て 使用 し ます 
) 


※[ ] は 必要 が な い 場 合 、 省 略 可能 な こと を 意味 し ます 。 
※ param1:dataType,…paramN:dataType は 1 つ 以 上 の パラ メー タ が 記述 で きる こと を 意味 し ます 。 


AMPLE ヒロ ロ DE 王 EE 


1F3 本 』 
ま 講 


世 渡す BasicSamtple 半 Ha 


Function getWordCount ( gentenoe : Str1ing, targeWord : Strinqg ):vo1d {一 
Ya 8 ヒ a エ 七 : 1 ユ n ロ ヒ =0 いり 
Ya CT : 1 ロキ =0: 

star = gerntencCe . indexOf ( tarqetWord, 8Ear ): 
whi1e ( start != -1 ) { 


gtart=sentenoe . 1ndexOf ( tarqgetWord , St 上 ar ヒ +1 ) : 


Cn ヒ 十 十 
) 
tracCe ( tarqgetWord + " は " + cnt + " 個 あ り ま す 。" ): 
) 
yar sentence : String = "while 文 を 使用 する と 、 あ る 式 の 値 が true の 間 、 処 理 を 繰り 返す こと 


が で きま す 。whi 1e 文 は 、 繰 り 返 し の 回 数 が 明確 に 決ま ら な いと き な ご に 使用 ご れ ま す 。『 : 


jeGtWordCournt ( sentence, "while" ): ーーー ーー 


TO) 


| で 作成 し て いる getVWVordCount 関 数 は 2 つの String パ バラ メー タ を 取り ます 。 関 数 の 処理 は 、 
1 番目 の パラ メー タ (sentence) で 与え られ る String か ら 2 番 目 の バ ラメ ー タ (targetWord) で 
与え られ る String を 検索 し て その 個数 を カウ ント し ます 。 3 で getWordCount 関 数 の 呼び 出 
し を 行っ て いま す 。 
6 


1-6-3 関数 か ら の 戻り 値 を 利用 する 





関数 は 呼び 出し 元 に 値 を 返す こと が で きま す 。 呼び 出し 元 で は 、 返 され た 値 は 変数 に 代入 す 6 
る な ど し て 利用 で きま す 玉 W 較 関数 に パラ メー タ を 渡す 」 で 解説 し た よう に 、 関 数 の 戻り 値 
が ある 場合 、() の 後ろ の : に 続け こそ の デー タ 型 (dataType) を 書き ます 。 戻り 値 が な い 場 
馬 、: void (ボイド と 読み ます ) を 記述 し ます 。 

戻り 値 を 定義 し た 場合 、 関 数 内 で 必ず return を 使用 し て 指定 し た デー タ 型 の 値 を 返し ます 。 


関数 戻り 値 の 構文 
Function Furnct1onName ( [param1 : dataType, . . .] ) : reEurnType 


/ / 戻り 値 を 定義 し た 場合 、 必ず return 句 で 指定 し た デー タ 型 を 返し ます 


retLuTn GELuTnDa も a: 


ーー 
誤 つ た 関数 定義 
Funotion wrongFunction ( param:int ) :Boo1ean { 
Var returnValue : Boolean : 
if (param<0) { 


return fFal8e : 


) 
if (param>0) { 


GELuTrT 巧 了 UG : 


定義 し た 関数 wrongFunction は Boolean 型 の 戻り 1 
値 が 0 の と き 、 何 も し な いで 終了 し ます 。 つ まり 戻り 1 
コン パイ ル エ ラー を 発生 し ます 。 


直 を 返す と 定義 し て いま す が 、param の 
直 を 戻し ませ ん 。 そ の た め 、 こ の 関数 は 
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1-6 
関数 を 使う 


AMPLE ヒロ ロ ヒ gkEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


関数 か ら の 戻り 値 を 利用 する BasicSample0.la 


Function detWordCount ( sentenCe : S 上 1nd, argdetWord : S 上 1nq ) :1n キ {一 ① 
Ya ga エ : ユ n ロ ヒ =0: 
Var Cr : 1n 七 =0: 
gtar = gentenoe . 1ndexOf ( tarqetWord, start ): 
whi]1e ( start != -1 ) {1 
gtar キ =sentenCe . 1nQdexOf ( tarqdeWord , 8 上 ar+1 ) : 
Cn 革 二 : 


YeG 二 UTF Cm も 


) 


var sentenoe : St 上 rind = "while 文 を 使用 する と 、 あ る 式 の 値 が true の 間 、 処 理 を 繰り 返す こと 
が で きま す 。whi1e 文 は 、 繰 り 返 し の 回 数 が 明確 に 決ま ら な いと き な ど に 使用 され ます 。" : 
Var Crt : in = qetWordCount( sentenoe, "while" ): ーー (の 





trace( "while は 『 + cn + " 個 あ り ま す 。『 ): 


「 関 数 に パラ メー タ を 渡す 」 の 関数 の 改良 型 で す 。 ① で 作成 し て いる getWordCount 


関数 は 2 つの String パ ラメ ー タ を 取り 、1 番 目 の バ ラメ ー タ (sentence) で 与え られ る String か 
ら 2 番 目 の パ ラメ ー タ (targetVWord) で 与え られ る String を 検索 し て その 個数 を カウ ント し 、 
カウ ント 値 を 戻り 値 と し て 返し ます 。 


@ で getWordCount 関 数 の 呼び 出し を 行い 、 戻 り 値 を cnt 変 数 に 代入 し て いま す 。 


> 実行 結果 


while は 2 個 あ り ま す 。 


(.…. rest) 





ActionScript で は 、 関 数 が 受け る パラ メー タ の 数 を 可変 に する こと が で きま す 。 こ の 場合 、 6 
渡さ れ た パラ メー タ は 配列 と し て 処理 で きる よう に な り ま す 。 つ まり 、 い くつ の パラ メー タ が 唐 詞 
渡さ れ て いる か を length プ ロ パ ティ で 調べ る こと が で きま す 。 関数 の パラ メー タ 数 を 可変 に す 
る に は 、 関 数 名 に 続く ( ) 内 で ...rest を 記述 し ます 。 こ の 場合 、rest は 関数 内 で 配列 と し て パラ 
メー タ を 取り 出す た め に 使用 で きま す 。 必 ず し も rest と いう 名 前 を 使用 する 必要 は あり ませ ん 。 


可変 パラ メー タ の 構文 
funcCtion fumct1onName ( ... regt ) : returnTyDpe 


// rest は 配列 と し て 、 渡 され た パラ メー タ を 格納 し て いま す 


1 四 3 首 可 mg】 粒 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


関数 か ら の 戻り 値 を 利用 する BasicSamplePfla 








Function getSum( . . . params ) :Number 1 1 


Var 8Um : NumDer=0 : 


For (var 1:uint = 0: 1 < params.1enqgth: 1++) {1 
8um=Sum+DaramS8 [1] : ーー 


NN) 


retuTn Sum: 


) 

Yar 8um5 : Number=qdetSum(1,2,3,4,5): 

Var 8um10 :NumDoer=qetSum(1,2,.3,4,.5,6,7,8,0,10): 

trace ( "1 か が か ら 5 まで の 和 は " + sum5 + ", 1 が ら 10 ま で の 和 は " + gum10 + "で す 。『) : 


か ら の 関数 getSum は 、 可 変 個 の 引数 を と り 、 渡 され た 引数 の 和 を 返し ます 。params と 
いう 配列 に 渡さ れ た バラ メー タ が 格納 され ます 。 そ の 処理 を ② で 処理 し て 変数 sum に 合計 値 を 
格納 し て いま す 。 


> 実行 結果 
1 か ら 5 まで の 和 は 15 , 1 か ら 10 ま で の 和 は 46 で す 。 
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] - 7 エ エ ラー 処理 を 行う 
エラ ー が 発生 し た と き の 処 理 を 行う 





PART ActionScript プ ログ ラム の 実行 中 に エラ ー が 発生 する と 、Flash Player は 例外 を スロ ー 
生計 (throw) し て アプ リケーション の 実行 を 中 断 し ます 。 ス ロー され た 例外 は キャ ッ チ (catch: 捕 
捉 ) し て プロ グラ ム で 適切 に 処理 する こと が で きま す 。 こ の 処理 を エラ ー 処 理 、 あ る い は 例外 
処理 と 呼び ます 。Flash Player は 、 例 外 を スロ ー す る 際 に Error オ ブ ジ ェクト を 生成 し て エラ ー 
の 詳細 情報 を 格納 し ます 。 キ ャ ッ チ し た コー ド で その Error オ ブ ジ ェクト の 内 容 を 見 て 処理 を 
行う こと が で きま す 。 例外 を 発生 する 可能 性 が ある コー ド 部 分 は try { }) ブロ ッ ク に 含め ます 。 
ブロ ッ ク の 後に catch (error: ErrorType ) { } を 記述 し 、 そ の ブロ ッ ク で エラ ー 処 理 を 行い ま 
す 。catch ブ ロッ ク は エラ ー の 種類 ご と に 複数 書く こと が で きま す 。 finally { }) ブロ ッ ク に より 、 

エラ ー が 発生 し た と きも そう で な いと き に も 実行 する コー ド を 記述 で きま す 。 


エラ ー 処 理 の 構文 


上 FTY 
( 
/ / エ ラー が 発生 する 可能 性 の ある コー ド 
) 
Catoh ( errOr [ : ErrorTyDe1] ) 
( 
/ /ErrorType1 が 補足 され た 場合 の エラ ー 処 理 
//ErrorType1 指 定 し な い 場 合 は すべ て の エラ ー が 補 定 され る 
) 
[catch ( error : ErOrTyDe2 ) 
( 
/ /ErrorType2 が 補 定 され た 場合 の エラ フー 処理 
[Final]y 
( 
/ / 必 ず 実 行 す る 処理 


※[ ] は 必要 が な い 場 合 、 省 略 可 能 な こと を 意味 し ます 。 つ まり 、catch ブ ロッ ク は 最低 1 つ 以 上 
記述 し ます 。finally ブ ロッ ク は 必要 な ら 記 述 し ます 。 


AMPLE C ロ DE EEE 


try - catch に よる エラ ー 処 理 BasicSampieN.fla 


1mport fFl]ash.d1isplay .MoV1eC11p: 
va mc:iMovieC1ip 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーー①MovieClip クラ ス の 変数 を 宣言 


32 try { 


1-1-1 
ActionScript バ ー ジ ョ ン と Flash Player、 AVM の 互換 性 を 確認 する 


mC.p1aY ( ) : 一 一 ーー 一 ーーーーーー- ② メ ソ ッ ド を 呼び 出す 
} catch( e:TypeError ) {一 一 一 一 一 一 一 ーー 一 ーーーーーーーーー ③catch ブ ロッ ク の 処理 
trace( @e ): 
) Eina11y { 
trace ( "fina11y が 呼ば れ ま し た ): 


で MovieClip ク ラス の 変数 を 宣言 し こい ます が 、new に よる イン スタ ンス 化 を 行っ て お ら 
ず 、null 値 を 持っ て いま す 。 そ の た め 、② で メソ ッ ド を 呼び 出す と き に ラン タイ ム エ ラ ー が 発 
生 し ます 。 こ の と き の Error オ ブ ジ ェクト は TypeError な の で 、3⑬ か ら 始 まる catch ブ ロッ ク で 
処理 され た 後に finally ブ ロッ ク が 実行 され ます 。 


ぁ 実行 結果 
TypeE エ Or : E エ Or 提 1009: nu11 の オブ ジェ クト 参照 の プロ パテ ィ ま た は メソ ッ ド に アク セス する 
こと は で きま せん 。 
Fina1 1]y が 呼ば れ ま し た 


生 Error オ ブ ジ ェクト の 種類 






Error オ ブ プ ジ ェクト 発生 タイ ミン グ 
関数 で 指定 され た 引数 が その 関数 の 定義 に 適合 し て いな いと き 
定義 済み の 識別 子 を ユー ザー コー ド で 定義 し よう と し た と き 


ユー ザー コー ド が Function オ ブ ジ ェクト で eval() 関数 を 呼び 出す 、 ま た は new 演 
算 子 を 使用 し よう と し た と き 


llegalOperationError メソ ッ ド が 実装 され て いな いか 、 実 装 が 対応 し て いな いと き 
InvalidSWFError 破損 し た SWF フ ァイル を 検出 し た と き 

IOError 入出 力 エラ ー が 発生 し た と き 

MemoryError メモ リ 割 り 当 て 要求 が 失敗 し た と き 


RangeError 数 値 の 値 が 許容 範囲 内 に 収まら な いと き 


ReferenceError sealed 指 定 さ れ た 動 的 で な い オ ブ ジ ェクト に 対し て 未定 義 プ ロ パ ティ を 参照 し よ 
うと し た と き 


ScriptTimeoutError スク リプ ト の タイ ム ア ウ ト 間 隔 が 経過 し た と き 
SecurityError セキ ュ リ ティ の 侵害 が 発生 し た と き 


VideoError FLVPlayback ま た は VideoPlayer ク ラス で 問題 が 発生 し た と き 



















ArgumentError 






DefinitionError 


EvalError 











33 


PART 


34 


1 - 8 イベ ント の 処理 を 行う 
イベ ント リス ナー を 作成 する 





ユー ザ が マウ ス を クリ ッ ク す る と click イ ベン ト が 発生 し 、MouseEvent と いう オブ ジェ クト 
が 生成 され 、 登 録 さ れ た 関数 で その イベ ント と オブ ジェ クト を 捕捉 し て 処理 で きま す 。 こ の よ 
うに ユー ザ の 操作 や シス テム か ら 発 せら れる 情報 は イベ ント と し て 送信 され 、 登 録 さ れ た 関数 
で 処理 を 行い ます 。 そ の 関数 は イベ ント の 発生 を 監視 する こと に な る た め 、 イ ベン トリ スナ ー 
(Event Listener) 関数 、 ま た は イベ ント ハン ドラ (Event Handler) と 呼ば れ ま す 。 通常 の Act 
ionScript 関 数 また は クラ ス 内 に 作成 され た メソ ッ ド を イベ ント リス ナー と し て 使用 で きま す 。 
その た め 、 イ ベン トリ スナ ー の 作成 方 法 は 関数 の 作成 方 法 と 共通 し ます 。 リ スナ ー 関 数 は イベ 
ント オブ ジェ クト を バラ メー タ (event:eventObjectClass) と し て 受け る と ころ が 特徴 的 で す 。 
パラ メー タ の デー タ 型 は 処理 する イベ ント オブ ジェ クト を 指定 し ます 。 例 えば マウ ス 関 連 の イ 
ベン ト の 場合 、MouseEvent オ ブ ジ ェクト が 送出 され る の で 、event:MouseEvent と し ます 。 


イベ ント リス ナー の 構文 
Function 11gstener ( event : eventOb]ectClasgs ) : Vo1d 


( 
/ / event 上 パラ メー タ を 使用 し た イベ ント の 処理 


※ パラ メー タ 名 は 必ず し も event で ある 必要 は あり ませ ん 。 


イベ ント リス ナー の 登録 

イベ ント リス ナー 関数 の 登録 は 、addEventListener() 関 数 を 使用 し ます 。 こ の 関数 の 第 1 パ 
ラメ ー タ (type) に 対象 の イベ ント 名 、 第 2 バ パラメータ (listener) に リス ナー 関数 の 名 前 を 渡し 
て 実行 する こと で 登録 が 完了 し ます 。 こ の メソ ッ ド は EventDispatcher ク ラス の も の で す が 、 
この クラ ス は DisplayObject の スー バー クラ ス で ある た め 、 ほ と ん どの コン ポー ネン ト で add 
EventListener() メ ソ ッ ド を 使用 で きま す 。 


イベ ント リス ナー 登録 の メソ ッ ド 
pub11o funoction addEventLi1 stener (上 yDe : S 上 て 1nmd, 118tener : FunC 七 1On , 
useCapture : BOOlean = fal8e, D エ 1O エ 1tY:1nE = 0, useWeakReferenCe : 


Boo1ean = fal]se) :Vo1d 


※ 弟 3 パ ラメ ー タ 以下 は デフ ォ ル ト 値 が 設定 済み で 、 省 略 可 能 で す 。 


イベ ント リス ナー の 削 隊 
イベ ント リス ナー 関数 の 登録 を 削除 で きま す 。 削 除 は removeEventListener() 関 数 を 使用 し 


せ ーー1 
イベ ント リス ナー を 作成 する 


ます 。 こ の 関数 の 第 1 バラ メー タ (type) に 対象 の イベ ント 名 、 第 2 パラ メー タ (listener) に リ 
スナ ー 関 数 の 名 前 を 渡し て 実行 する こと で 削除 が 完了 し ます 。 こ の メソ ッ ド も EventDis 
patcher ク ラス の も の で す 。 





イベ ント リス ナー 削除 の メソ ッ ド 
pub]1C fFuncCt1ion removeEventL1stener (tyDe : S 上 r1nd, 11gtener : FunmnC ヒ 1On , 


useCapture : Boolean = false) :Vo1d 


※ 第 3 パラ メー タ は デフ ォ ル ト 値 が 設定 済み で 、 省 略 可 能 で す 。 













ァ ー ニテ 


イベ ント リス ナー の 登録 を 行う 


ボタ ンコ ン ボ ー ネ ン ト 





イベ ント リス ナー の 登録 


イベ ント リス ナー の 削除 









| 押し て くだ あい 


メッ セー ジ を 出力 








ボタ ン が 押さ れ ま し た 


ニコ 画 コ 首 mp】 ヨ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


イベ ント リス ナー の 登録 / 削 除 処理 BasicSampleR.fla 


// イ ベン トリ スナ ー の 登録 ボタ ン 
this .Dutton1 . addEventL1stener( MouseEvent .CLTCK, button1Listener ): 
Function button1Listener( event :MouseEvent ) :void 1 

thisg .button3 . addEventL1stener( MouseEvent .CLTCK, button3Listener ) : 
) 
// イ ベン トリ スナ ー の 解除 ボタ ン 
this . button2 . addEventL1stener( MouseEvernt .CLTCK, button2Ligtener ) : 
Function button2Li1stener( event :MouseEvent ) :vo1d { 

thig .button3 . removeEventL1stener ( MouseEvent .CLTCK, button31L1Stenmer 
) : 
) 
/ / メ ッ セ ー ジ を 出力 する 処理 
Function button3Liistener ( e:MouseEvent ) :vo1d { 

this .output ta.textE += "ボタ ン が 押さ れ ま し た ": 
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ヘン ス トシ アン キン は え ::k 有 まっ 








堅 還 剛 |「 イベ ント リス ナー を 作成 する 」 で 解説 し た よう に 、 イ ベン ト の 種類 に 応じ て 生成 さ 
れる オブ ジェ クト が 異な り ま す 。 例 えば マウ ス 関 連 の 操作 で は MouseEvent オ ブ ジ ェクト が 、 
ファ イル を ロー ド す る と き の progress イ ベン ト で は ProgressEvent オ ブ ジ ェクト が 生成 され ま 
す 。 こ の よう に イベ ント の 種類 に よっ て オブ ジェ クト が 異な る の は 、 格 納 す る 情報 が 異な る た 
めで す 。 リ スナ ー の 処理 で は この イベ ント オブ ジェ クト が 持つ 情報 を 利用 し ます 。 例 と し て 、 
MouseEvent オ ブ ジ ェクト が 持つ プロ バ パティ を 見 て みる と 、 下 表 の よう な プロ パテ ィ が 用 意 さ 
れ て いま す 。 例 えば ボタ ン が クリ ッ ク さ れ た と き 、Ctrl キ ー と At キー が 押さ れ て いる 場合 、 
altKey プ ロ パ ティ と cdtrIKey プ ロバ ティ の 値 が true に セッ ト さ れ ま す 。target プ ロバ ティ は ユ 
ー ザ か ら 見 た 場合 、 通 常 イ ベン ト の 発生 元 へ の 参照 を 表し ます 。 


mi MouseEvent オブ ジェ ク ト の 主 な プロ バテ ィ 

































































プロ パテ ィ 内 容 

altKey:Boolean ーー At キー が アク ティ ブ の 場合 、true 

buttonDown:Boolean マウ ス の 主 ボ タン が 押さ れ て いる 場合 、true ] 
ctrIKey:Boolean Ctrl キー が アク ティ ブ の 場合 、true 

localX:Number ーー スプ ライ ト を 基準 と し た マウ スカ ー ソ ル 水 平 位置 
localY:Number スプ ライ ト を 基準 と し た マウ スカ ー ソ ル 垂 直 位 置 
STGVBOG5aD Shift キ ー が アク ティ ブ の 場合 、true | 
stegeX:Number ステ ー ジ を 基準 と し て マウ スカ ー ソ ル 水 平 位置 

stageY:Number ー ステ ー ジ を 基準 と し て マウ スカ ー ソ ル 垂 直 位置 ] 
target:Object イベ トド ダ ター ゲッ ト ' ーー 

type:Strind イベ ント の タイ プ 





民 E 較 |「 イ ベン トリ スナ ー を 作成 する 」 の サン プル を 拡張 し て イベ ント オブ ジェ クト の 内 容 
を 出力 し ます 。 


m マウ ス 関 連 イ ベン ト の 定数 




















| CLICK Click 
DOUBLE_CLICK doubleClick 
MOUSE_DOWN mouseDown 





mm 














LE 5 
イベ ント オブ ジェ クト を 利用 する 


笠 マウ ス 関 連 イ ベン ト の 定数 (続き) 















定数 イベ ント 


1 画 ヨコ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 










ファ イル (F) 避 示 Y) 天 御 (CO デバ ッ グ (D) 


| イベ ント リス ナー の 登 緑 | イベ ント リス ナー の 削除 


押し て くだ あい 


イベ ント の 種類 : roWOver 

| At キー の アク ティ ブ :fmlsa 
ctl キー の アク ティ ブ :false 
Shift キー の アク ティ ブ : false 
ロー カル 座 帆 :(40) 

ステ ー ジ 座 覆 :(238.122) 


イベ ント の 種類 : rolOver 
AN キー の アク ティ ブ :1alse 

Ctrl キー の アク ティ ブ : false 
shift キ ー の アク ティ ブ :false 


= を W% 画 = 首 中 mp】 コ 蘭 -- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


イベ ント オブ ジェ クト の 利用 BasicSampleS.fla 


// イ ベン トリ スナ ー の 登録 ボタ ン ①click イ ベン トリ スナ ー の 登録 
thig .button1 . adQdEventL1istener( MouseEvernt .CLTCK, button1Ligtener ): 
Function button1Listener( event :MouseEven ) :vo1d { 

thig .button3 . addEventTLi1stener ( MouseEvent .CLTCK, button3Listener ): 

thisg . button3 . addEventL1gtener( MouseEvent . ROLL OVER , button3 

EE 計上 導 も 者 ) ァ ーーーーーーーーーー ーーー ーー folover イベ ンド トド け ス ナー の 但 際 


) 
// イ ベン トリ スナ ー の 解除 ボタ ン ③ リ スナ ー の 削除 


thig .button2 . addEventListener ( MouseEyvent .CLTCK, button21Listener ): 


Funotion button2Listener( event :MouseEven ) :vo1d { 





thig .button3 . remoVveEventL1iStener( MouseEvent .CLTCK, button3 


iistener ): 
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1-8 
イベ ント の 処理 を 行う 


Ehig .button3 . removeEventL1stener( MouseEvent . ROLL, OVER , button3 
Listener ): 


) ③ リ スナ ー の 削除 
/ / メ ッ セ ー ジ を 出力 する 処理 


Funotion button3Liistener ( e:MouseEvent ) :vo1d { 
th1g8 .OuEtDu 上 上 a.tex += 
イベ ント の 種類 : + e.type + " ぎ \n" + 
A1 モ キー の アク ティ ブ : + e.a1tKey + "nm" + 
ct モエ 1 キー の アク ティ ブ : + e.ctr1Key + "\ ま mn" + 
shift 上 キー の アク ティ ブ : + e.gshifFtKey + " ぎ n" + 
ロー カル 座標 :( + e.1oca1X + "," + e.1ocalY + ")" + " 学 n" + 


ステ ー ジ 座標 :( + e.stageX + "," + e.8tadeY + の) 7 ト 『n7: 


① と ② で "click" と "rollover" イ ベン ト に 対し て リス ナー の 登録 を 行っ て いま す 。 こ の 場合 、 


3③ で 行っ て いる よう に 、 リ スナ ー の 削除 も 2 つの イベ ント に 対し て 行う 必要 が あり ます 。 








II 
イベ ント の 発生 と イベ ント フロ ー 

Flash Player ま た は AIR で は 、 イ ベン ト が 発生 する た びに イベ ント オブ ジェ クト が 作成 
され 、 送 出さ れ ま す 。 イ ベン ト タ ー ゲ ッ ト が 表示 リス ト 内 に な い 場 合 、 イベ ント ター ゲッ 
ト に 対し て 直接 に イベ ント オブ ジェ クト が 送出 され ます 。 こ の 時 、 イ ベン ト タ ー ゲ ッ ト が 
表示 リス ト 内 に あれ ば イベ ント オブ ジェ クト は 表示 リス ト に 対し て 送出 され 、 表 示 リ スト 
の 階層 内 を 経由 し て イベ ント ター ゲッ ト に 到達 し ます 。 表 示 リ スト 内 を イベ ント オブ ジェ 
クト が 伝わる 経路 が イベ ント フロ ー で す 。 表 示 リ スト の 階層 構造 の 最上 位 は ステ ー ジ で す 
が 、 イ ベン ト オ ブ ジェ クト が 作成 され て 送出 され る と 、 そ の オブ ジェ クト は ステ ー ジ か ら 
ター ゲッ トノ ー ド まで を 往復 し ます 。 

イベ ント フロ ー の 第 1 段階 は キャ プチ ャ 段階 と 呼ば れ 、 ス テー ジ か ら タ ー ゲ ッ ト ノ ー ド 
の 親 ま で の ノー ド ま で 伝播 (で ん ば ん ) し ます 。 次 の 第 2 段階 は 、 ター ゲッ ト 段 階 と 呼ば れ 、 
ター ゲッ トノ ー ド に 到達 し ます 。 最 後 の 第 段階 は バブ リン グ 段 階 と 呼ば れ 、 タ ー ゲ ッ ト 
ノー ド の 親 か ら ス テー ジ に オブ ジェ クト が 戻さ れ ま す 。 








1] - 9 クラ ス と イン スタ ンス 
「 クラ ス を 宣言 する 





クラ ス を 使わ な く て も Flash の ActionScript プ ログ ラミ ング が 可能 で す が 、 作 成す る アプ リ 9 
ケー ショ ン の 規模 が 大 きい 場合 や チー ム で 開発 する 場合 ど は オブ ジェ クト 指向 の 方 法 を 取り 
人 入れ る と 開発 の 効率 性 や 保守 性 が 高まり ます 。 ま た 、ActionScript 3.0 コ ン ポ ー ネ ン トリ ファ 
レン スガ イド で 示さ れる 開発 者 向け の プロ グラ ミン グイ ンタ フェ ー ス は クラ ス で 構成 され る ラ 
イブ ラリ と な っ て いま す 。 ク ラス の 宣言 は 、class キ ー ワ ー ド に 続け ご クラス 名 を 記述 し ます 。{ 

} プ ロッ ク 内 に クラ ス の プロ パテ ィ と な る 変数 と 、 メ ソ ッ ド と な る 関数 を 宣言 し ます 。 


クラ ス の 宣言 構文 
[package packageName { ] 
[dynamic] [pub1ic | interna1] [Eina1] cl1ass className [ extends 


SuperClass ] [ 1mplements nterfFaceName [, interfaceName. .. ] ] { 
// ク ラス の プロ パテ ィ と メソ ッ ド を 作成 し ます 


) 
[ ) ] //package 宣 言 の ブ ロッ ク 終 了 


※[ ] で 囲ま れ た キー ワー ド は オプ ショ ン で 、 必 要 な い 場 合 、 省 略 可 能 で す 。 次 の 表 に オプ ショ 
ン の 概要 を 示し ます 。 


御 class 宣言 の と き に 追加 で きる オプ ショ ン 


package DackageName packageName で 示さ れる パッ ケー ジ に 属す る クラ ス に し ます 。 パ ッ 
1 ケー ジ 名 は クラ ス フ ァ イル を 格納 する フォ ル ダ 名 と 同一 に し ます 。 














dynamic クラ ス の イン スタ ンス を 生成 後に プロ パテ ィ を 追加 で きる よう に し ま 
す 。 追加 され た プロ パテ ィ は for jn 構文 で 取り 出す こと が 可能 に な り 
ます 。 











public この クラ ス を 使用 する 場所 に 制限 を 設け ませ ん 。 パ ッ ケ ー ジ 内 外 に か 


か わら ず 、 使 用 可能 に し ます 。 


internal 同じ パッ ケー ジ 内 の 他 ク ラス か ら の み 、 こ の クラ ス を 使用 で きる よう 
に し ます 。 public/internal を 指定 し な い 場 合 の デフ ォ ル ト は internal 
の まん 


























この クラ ス を 拡張 で き な い よう に し ます 。 
extends SuDerClass SuperClass で 指定 され る クラ ス を 拡張 する クラ ス を 宣言 し ます 。 














implements interfaceName | interfaceName で 指定 され る イン タフ ェ ー ス を 実装 する クラ ス を 宣言 
] し ます 。 


※ public と internal は 、 宣 言 す る クラ ス が 外部 の どの 場所 か ら 使 用 で きる か を 制限 する アク セス 
制御 の 働き に な り ま す 。 
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クラ ス は イン スタ ンス を 生成 し て 初め て オブ ジェ クト (実体 ) とこ なり 、Flash Player 上 で 動作 


PART 
する よう に な り ま す 。 ク ラス の イン スタ ンス を 生成 する に は 、 変数 を 宣言 し て new 演 算 子 の 結 


果 を 代入 し ます 。 


4 全 by リ 相 "4 
yar instanceName: ClassName = new Con8tructor( parameter8 ): 


※ className と constructor は 同じ 名 前 に な り ま す 。 


AMPLE C ロ ロ E 還 EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


時 言 と 使用 (クラフ ラス 宣言 SimpleClass.as 


す - > 一 





D り パッ ケー ジ の 宣言 





package {1 ーーーーーーーーーーーーーーーー 
pub1ic cl1aggs Simp1leClas8 { 一 一 一 ーーーーーーーーー @SimpleClass クラ ス を public で 作成 
pub11C Ya myPrODery : S 上 エ 1md: ー③ ク ラス の プロ パテ ィ は 変数 と し て 室 言 





pub1ic function myMethod ( ) :void {一 ④ ク ラス の メソ ッ ド は 関数 と し て 宣言 


raCe ( "myPrODer ヒ 上 Y=" + myPrODerty ): 


| で パッ ケー ジ 宣 言 を し ます 。 バ パッケ ー ジ を 作成 し な い 場 合 、 こ の よう に バッ ケー ジ 名 を 書 
か ず に 宣言 で きま す 。 そ の 場合 、 特 に フォ ル ダ を 作成 し て as ファ イル を 保存 する 必要 は あり ま 
せん 。 


クラ ス を 作成 する に は 、 タ イム ライ ンス クリ プ ト で は な く 、 外 部 AS ファ イル を 作成 する 必要 
が あり ます 。 サ ンプ ルコ ー ド は SimpleClass.as と いう ファ イル 名 で 保存 し ます 。 


コ フ ス ト ラダ 

コン スト ラク タ (constructor) 関数 は 、new 演 算 子 に よっ て クラ ス の イン スタ ンス を 作成 す 
る と 同時 に 実行 され る メソ ッ ド と 言え ます 。 コ ンス トラ クタ は 定義 され た クラ ス と 同じ 名 前 に 
な り 、 戻 り 値 を 指定 する こと は で きま せん 。 
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Fssh ファ ル (AS 3.0) 新しい 部 ActonScrpt ファ イル (*. ぶ ) を 作成 し 、 スカ リブ トウ ィ ン ド 
Rssh ファ イル (AS 2.0) り で 統 集 し ます 。 ActonScrnt は Fssh の スゲ リブ 、 
Fash ファ イル (AOobe A 了 ) アプリケ ー ツ ョ ン PNOD ア ウツ ョ ン 、 清和 宣子 、 オ ブウ ェ ウ ト 、 カ う な ど 

ド 0 細 に 重用 し ます 、 コ ー ド ヒン ト や スカ リ ブ ト 細 ウール を 人 用 し て 
Fash ファ イル (モバ イル ) リナ ト を 作成 で き 、 外部 ス が リブ ト は 裸 堆 アリ ケー ジョ ン で 再 利用 で きま 
スラ イド ブル ぜ ゼン テー ショ ン ま R RUP ブロ ヴェ クト ファ イル で RA ドキュ メッ ト へ の 外部 ハリ ブ ト ンク 
フォ ー ム アプ リ ケ ー ツ ョ ソ や ソー メコン トロ ー ル の ① 玲 定 を 行え ます 、 





で AS ま ュ ニケ ー ツ ョ ン ファ イル 
で Fash JavaScrpt ファ ル 
ーー Fsh ブロ ジェ クト 











= 和良 肖 = 考 四 mp】 コ 敵 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


クラ ス を 使う BasicSampleTila 
Var myOb] :S1mpleClasg = new SimpleC1ass () : --ーーーーー ⑤ ク ラス イン スタ ンス を 生成 
myOD] 、WVProperty = "プロ パティ の 値 " , - 一 一 一 ーーーーーーーー ク ラス の プロ パティ に 値 を 設定 





myOb] . myMethod ( ) : ⑦ ク ラス の メソ ッ ド を 呼び 出す 


5 で クラ スイ ンス タン ス を 生成 し ます 。 こ の 後 イ ンス タン ス は myObj と いう 変数 で 処理 で き 
ます 。 


サン プル コー ド は FLA フ ァイル の タイ ムラ イン スク リプ ト に 記述 で きま す 。SimpleClass ク 


ラス を FLA フ ァイル か ら 使 用 する 場合 、SimpleClass.as フ ァイル を 同じ フォ ル ダ に 保存 し て お 
きま す 。 


> 実行 結果 
myProODer モ エマ = プ ロ パ ティ の 値 
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PART 


4Z 


表 ノ ルル ア く ノア 4=『A と さそ ジ ルス 
作成 する 


葉 多 久 | クラ ス を 使う 」 で 解説 し た よう に すべ て の プロ パテ ィ と メソ ッ ド を public に する と 、 
クラ ス を 使う 側 か ら は 自由 に アク セス で き て 便利 で す 。 し か し 上 自由 な アク セス を 許可 する と 、 
不正 な プロ パテ ィ 値 が 設定 され る こと を 防ぐ こと が で きま せん 。 そ の た め 、 プ ロバ ティ は 
private に し て アク セス を 制限 し 、 専 用 の public メ ソ ッ ド を 用 意 し て 値 の チェ ッ ク な ど を 行い 
ます 。 ク ラス の private プ ロ パ ティ に 値 を セッ ト す る た め の public メ ソ ッ ド は 、set を 付加 し て 
作成 し ます 。 こ れ は 、set メ ソ ッ ド と 呼ば れ ま す 。 ク ラス の private プ ロバ ティ 値 を 取り 出す た 
め の public メ ソ ッ ド は 、get を 付加 し て 作成 し ます 。 こ れ は 、get メ ソ ッ ド と 呼ば れ ま す 。set 
/ get が 付加 され た public メ ソ ッ ド の 呼び 出し は 、 下 記 の 「setVget メ ソ ッ ド の 使用 ] の 例 の よう 
に 、 プ ロ パ ティ に アク セス する よう に 行う こと が で きま す 。 








set メ ゾ ソ ッ ド の 構文 
pub]1ic funotion se property (newValue : dataTyPe) : vo1d1 
// newValue の 値 を チェ ッ ク し て 代入 を 行い ます 。 


qet メ ソ ッ ド の 構文 
pub]11c Funotion de 上 prODer て ty () : QataType 1 
/ / 値 を return し ます 。 


set / get メ ソ ッ ド の 使用 


var myOb] :MyClasg = new MyClasg() : 
myOb] .property = newValue: // こ の と き 、set 上 メソ ッ ド が 呼び 出さ れ ま す 。 
traCe ( myOb] .DrODerty ): / / こ の と き 、get メ ソ ッ ド が 呼び 出さ れ ま す 。 


※ myObj.property と 記述 し て いま す が 、property は public メ ソ ッ ド 名 で す 。 


らら AMPLE ビ ロ ロ DE EE 


クラ ス の プロ パテ イィ と メソ ッ ド を 作成 する SimpleClass2.as 


package { 
pub1ic cl1ass SimpleClasg2 { 


private Var myPr1Ce:inEt = 0: ーーー① ク ラス の プロ パテ ィ イ を 宣言 


ョ ーー は 
クラ ス の プロ パテ ィ と メソ ッ ド を 作成 する 





1f ( newValue < 0 ) return:  //newVa1ue が マイ ナス 値 の と き 、 何 も し ませ ん 
myPrioe = newValue : @ ク ラス の set メ ソ ッ ド を 宣言 一 
) 9 
pub11C funmction get price ( ) : nt { 一 一 ーーーーーー③ ク ラス の get メソッド を 宣言 
eurn myPr1CG : 


pub11C funotion se prioce( newVa1ue:int ) :vo1d 1 ' ue 


りり : クラ ス の プロ バテ ィ を private 変 数 と し て 宣言 し ます 。 初期 値 は 明示 的 に 0 と し ます 。 

2 : クラ ス の set メ ソ ッ ド を price と いう 名 前 で 宣言 し ます 。 こ の メソ ッ ド で 値 チ ェ ッ ク を 行 
い 、 マ イナ ス 値 は 無視 し ます 。 

3 : クラ ス の get メ ソ ッ ド を price と いう 名 前 で 宣言 し ます 。 


= た 5M 訓 目 = 才 mmlp】 コ 蘭 ---、 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


クラ ス の プロ パテ ィ を 使う BasicSampleU.fla 
Var myOb] : SimpleClass2 = new Simp1eC1asg2 () : 

培い 補記 二 ww 3307 デーーーーーーーーーーーーーーー ーー ーー の ツク ラス の プロ / パ ザイ に 杯 正 な 備 友 設定 
traCe( "-10 を セッ ト し まし た 。 実際 の 値 は " + myOb]j .price ): 

myOb] . pr1Ce = 10: 一 一 一 ーーーーーーーーーーーーーーーーー⑤⑤ ク ラス の プロ パテ ィ に 正しい 値 を 設定 
trace ( "10 を セッ ト し まし た 。 実際 の 値 は " + myOb] .price ): 


ぁ > 実行 結果 


-10 を セッ ト し まし た 。 実際 の 値 は 0 
10 を セッ ト し まし た 。 実際 の 値 は 10 
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0 二 和 ル レ ルク を さて Pr 1 の う シ ルル 
作成 する 





PART すでに 作成 済み の クラ ス に 機能 追加 を 行い 新しい クラ ス を 作成 で きる こと が で きま す 。 こ の 
機能 追加 を 継承 (inheritance)、 ま た は 拡張 (extention) と 呼び ます 。 継 承 し た クラ ス を さら 
に 継承 する こと も で きる た め 、 既 存 の 資産 を 継続 し て 利用 で きる こと に な り ま す 。 元 の クラ ス 
を スー パー クラ ス (super class)、 拡 張 し た 新しい クラ ス は サブ クラ ス (sub class) と 呼ば れ ま 
す 。 既存 の ActionScript コ ン ポ ー ネ ン トク ラス を 拡張 する こと も 可能 で す 。 ク ラス の 拡張 は 
extends キ ー ワ ー ド を 使用 し て 行い ます 。 新しい ク ラス に は スー バ パーク ラス の 内 容 が すべ て 堂 

まれ ます 。 


クラ ス の 拡張 構文 


cl1ass NewClassName extends SuperClassName {1) 


らら AMPLE ビ ロ ロ E EE 


MovieClip クラ ス を 拡張 する SimpleClass4.as 


package { 
1mport fF1]ash .d1isp1ay .MoV1eC11D: 
1mport fF]ash.text . TextF1e1d: 


/ /MovieC1 ip クラ ス を 拡張 し て 81mp1eClass4 を 作成 し ます 
pub1ic cl1ass SimpleC1ass4 extends MovieC1ip { ーー 一 一 ーーーー 


Va outputTa : TextF1e1d: 


/ / こ の メソ ッ ド は TextFie1d を 作成 し て 配置 し ます 
pub1ic funoction oreateTextFie1d() :vo1d { | 
outputTa = new TextFie1d(): 
outputTa . w1dth=gtaqe . SLadeW1dth*0.5: 





outputTa .height=stage . StageHe1qh*0.5: も . ーーーー 笠 


OutputTa . DaCKdrOUmnQ= ヒ UG : 





outputTa . .baCkdrOumndCO1Or=0xEEEEEE: 
addChi1d (outputTa) : コザ 


/ / こ の メソ ッ ド は TextFie1d に MovieC1 ip が 持つ プロ バテ ィ 値 を 表示 し ます 


pub1ic funoction showProper て ies ( ) :Yo1d { 
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ーー 
クラ ス を 拡張 し て 新しい クラ ス を 作成 する 


OutputTa . appendText ( getProperties() ): 


) 


Private Function getProper 上 eg ( ) : Sr1nd {1 一 ーーーーーーーーーーーーー ③ 
WAY も に Y:S も し Y1309 = 『W 9 
+ "CUYYenEFrame: " + CurrentEFrame + 『 ぎ mnm" 
+ "CuU エ YYGnESCene: " + CurrentSCene + " ぎ n" 
+ "Frame8sLoaded: " + framesLoaded + " ぎ \n" 
+ "totalFrames: " + tota1Frame8 + " ぎ nm": 


馬上 Um 8 七 了 : 


ステ ー ジ 上 の ムー ビー クリ ッ プ シン ボル イン スタ ンス は MovieClip ク ラス の イン スタ ンス で 
す 。 こ の た め 、ActionScript で MovieClip ク ラス を 拡張 し て 新た な クラ ス を 作成 し 、 シ ン ボ ル 
イン スタ ンス と 同じ よう に ステ ー ジ 上 に 配置 で きま す 。 

り : MovieClip ク ラス を 拡張 する SimpleClass4 の 宣言 を 行っ て いま す 。 

で 定義 され て いる createTextField メ ソ ッ ド を 実行 する こと に より 、TextField を 作成 し て 


配置 し ます 。 


3 か ら 定 義 ご され て いる getProperties メ ソ ッ ド は スー パー クラ ス で ある MovieClip ク ラス の 
プロ バテ ィ を 参照 し て その 値 を 返し ます 。 





ニア 1 ニ 』 肖 コ 科 mi mp】 コ 


MovieClip を 継承 し た SimpleClass4 クラ ス を 使う 
/ / ク ラス の イン スタ ンス を 生成 し て ステ ー ジ 上 に 配置 し ます 。 


// イ ンス タン ス の メソ ッ ド を 呼び 出し ます 。 
ob] .CreateTextF1e1d () : 


ob] . ShowPropert1e8g ( ) : 


BasicSamnleV.fla 


$ で SimpleClass4 の イン スタ ンス を 作成 し 、 配 置 し ます 。 配置 し た 後 で イン スタ ンス の メ 
ソ ッ ド を 呼び 出し て TextField の 構築 と デー タ の 表示 を 行い ます 。 
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PART 


| 


人 A シ ルル レス イコ Pk る コン 





作成 し た クラ ス が 多く な る 場合 、 そ の 整理 に は パッ ケー ジ に よる 分 類 が 必要 に な り ま す 。 
ActionScript コ ン ポ ー ネ ン トラ イブ ラリ も すべ て バッ ケー ジ 化 され て いま す 。ActionScript で 
は 、 パ ッ ケ ー ジ 名 は 物理 的 な フォ ル ダ 名 と 同一 で す 。 つ まり 、 作 成 し た as ファ イル を バッ ケー 
ジ 名 と 同じ フォ ル ダ に 格納 し ます 。 パ ッ ケ ー ジ 構造 に する こと で 、 同 じ 名 前 の クラ ス を 異な る 
パッケージ に 複数 作成 する こと も で きま す 。 通常 は 、 ク ラス の 宣言 を 行う と き に バッ ケー ジ の 
宣言 も 行い ます 。 宣言 し た クラ ス は その パッ ケー ジ に 属す る も の と し て 扱わ れ ま す 。 


パッ ケー ジ の 宣言 構文 
package packaqgeName { 


class ClassName { 
/ / ク ラス 内 部 の 定義 


ーー 


バッ ケー ジ を 使っ つ MyClass.as 
package myPackaqe{ 
dynamic pub1ic cl1ass MyClass { 

Dr1Vate Yar myPrODery : S 上 1rd: 

pub]ic funotion MyC1ass( myPropertyVa1ue: String ) :vo1d { 
myPrODG エ ヒ 上 =myPrODertyVa1Ue : 

) 

pub1ic funotion qet myproperty ( ) : String { 


return mVPTODG エ 上 


) 


pub1ic fFunotion se myproperty ( myPropertyValue : Strinq ):vo1d { 
my PrODG エ ヒ 上 Y=myPFODeGrEtyVa」1UG : 


myPackage と いう パッケージ に 属す る クラ ス と し て MyClass を 宣言 し ます 。 こ の Action 
Script は MyClass.as と いう ファ イル 名 で myPackage と いう 名 前 の フォ ル ダ 内 に 保存 し ます 。 
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Et 





1-9-5 
バッ ケー ジ を 理解 し て 使う 


2010/01/25 21:13 Cio 





| 個 の 項目 (空き ディ スク 領 虹 : 35.2 6B9 =。 HE RI ) 1 呈 204N RI 


mo モー ニニ ーーー 


AMPLE ヒロ DE EE 


パッ ケー ジ 宣 言 し た MyClass クラ ス を 使う PackageSample.fla 


1mport myPackaqe .MyCla88 : 
var myOb] :MyClass = new MyClass ( "パラ メー タ 値 " ): 
traoCe ( myODb] .myproDerty ) : 


myPackage バ パッ ケー ジ の MyClass ク ラス を 利用 する アプ リケーション で は 、 上 記 の よう に 
import 文 を 使用 し て クラ ス の 位置 を 明示 し ます 。 
この アプ リケーション ファ イル は myPackage フ ォ ル ダ が ある 場所 に 作成 し ます 。 


2010/01/26 23:13 ファ イル フォ ル ダ 


2010/03/02 0:54 Flash ドキ ュ メ ント 


M = Assets (M:)_ Eo "| as ーー ニーーーーーーー ド ーーーー ド ーーーー ニ ーーー ニー ニー ニー ユニ ーー ニー バーーaー ニ と やこ ペー ント ーー ニー ニー スー ペー ュー ニー テー に ーー ニー ムー こと ーー 
】 BasicSampleW.fla 更新 日 時 : 2010/03/02 0:54 
Flash ドキ ユメ ント サイ ズ ス : 29.0 KB 
: 2010/04/18 20:47 











ーー 号 OR ーー ビ ーー 
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PART 


っ 0 


2 - 1 日 付 と 時 刻 
Date オプ ジェ クト を 作成 する 





ActionScript で 日 付 と 時 刻 を 操作 する に は 、Date ク ラス を 使用 し ます 。Date ク ラス の イン 
スタ ンス は 、 例 えば 「2010/1171 13:00] と いう よう な 1 つの 日 時 デー タ を 保持 し ます 。 日 時 の 
情報 は 、 内 部 的 に は 、1970 年 1 月 1 日 0 時 0 分 0 秒 か ら の 経過 時 間 を ミリ 秒 単位 に 換算 し た 値 で 保 
持 さ れ ま す 。 ま た 、 特 定 の 日 時 を 保持 する Date イ ンス タン ス を 生成 する に は 、 コ ンス トラ クタ 
に 日 時 に 関す る デー タ を 渡し ます 。Date ク ラス の イン スタ ンス を 何 も 指定 し な いで 作成 する と 、 
現在 の 日 時 を 持つ よう に な り ま す 。Date ク ラス の イン スタ ンス を 作成 する 場合 、 下 表 の よう な 
複数 の 方 法 を 使い 分 け て 目的 の 日 時 を 格納 し ます 。 


Date クラ スコ ンス トラ クタ 


pub11o fFunotion Date (yearOrT1mevalue :Ob]ect , month :Number, dae : 
Numbper = 1, hour :Numbper = 0, minue :Numbper = 0, gecond:Number = 0, 


mt111gecond : NumDper = 0) 


香 Date クラ ス の コン スト ラク タ で イン スタ ンス を 作成 する 方 法 


var dt:Date = new Date( "文字 列 の 日 時 表現 " ): 
"文字 列 の 日 時 表現 "に は 、"1/30/2014" の よう な 文字 列 で 日 
付 を 指定 で きま す 。 


1970 年 1 月 1 日 午前 0 時 0 分 0.0 | var dt:Date = new Date( 1970/1/1 か ら の ミリ 秒 数 値 ): 
秒 か ら の 経過 時 間 を ミリ 秒 で 指 | 1970/1/1 か ら の ミリ 秒 数 値 が 計算 され て 、 そ の 時 点 の 日 時 
定 する が イン スタ ンス に 格納 され ます 。 


年 、 月 、 日 、 時 間 、 秒 、 ミ リ 秒 | var dt:Date = 

を 指定 する new Date( year, month[, date, hour, minute, second, 
msec ] ): 
年 、 月 以外 は デフ ォ ル ト 値 を 持つ た め 、 年 と 月 を 指定 する こ 
と で 日 時 デー タ を 作成 で きま す 。 こ の 場合 、 第 1 パラ メー タ 
は 年 の 指定 に な り ま す 。 





何 も 指 定 し な い var dt:Date = new Date(): 
コン スト ラク タ に 何 も パ ラメ ー タ を 渡さ な いと 現在 日 時 を 作 
成 で きま す 。 





た 1 画 コ 疾 置 mp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


日 時 を 設定 する DateSampleAfla 
/ / 特定 の 日 時 を セッ ト す る 


2-1-1 
Date オ ブ ジ ェクト を 作成 する 


//8String で セッ ト ( 2015 年 1 月 1 日 ) 
var dt1:Date = new Date( "01/01/2015『 ) : 一 一 ーーーーーーーーーーーーーーーーーーーー ①) 
trace( dt1 ): 


//1970/1/1 00:00 か ら の 経過 ミリ 秒 で 指定 
var Qt2:Date = new Date( 1300000000000 ): 
trace( dt2 ): 1 


/ / 年 、 月 、 日 、 時 、 分 、 秒 を それ ぞ れ 指定 (2012/11/31 23:59:59) 
var Qt3:Date = new Date( 2012, 11, 31, 23, 59, 59 ): 
trace( dt3 ): 


/ / 年 と 月 の み 指 定 (2013 年 1 月 ) 
var Qt4:Date = new Date( 2013, 1 ): 
trace( dQdt4 ): 


Date ク ラス の コン スト ラク タ に 日 付 の バラ メー タ を 渡し て イン スタ ンス が 持つ 日 時 を 設定 で 
きま す 。 の よう に 日 まで 指定 し た 場合 、Date イ ンス タン ス が 持つ 時 刻 は 0 時 0 分 に な り ま す 。 


ぁ 実行 結果 
Thu Jan 1 00:00:00 GMT+0900 2015 
Sun Mar 13 16:06:40 GMT+0900 2011 
Mon Dec 31 23:59:59 GMT+0900 2012 
Fr1 Feb 1 00:00:00 GMT+0900 2013 








Date クラ ス の toString() 書式 
Date ク ラス オブ ジェ クト を trace 出 力 す る と toString() メ ソ ッ ド が 自動 的 に 呼び 出さ れ 
ます 。 こ の と き の 日 付 フ ォ オー マット は 次 の よう に な り ま す 。 











Thu Jan 1 00:0O0:0O GMT「†0900 と 01c D 
5 
D り @$@③ ④ 6 @ 


に ニン 








り 過 日 ⑤ 月 ③ 日 ④ 時 刻 ⑤ 標 準 時 刻 と の 差 : 日 本 の 場合 、 GMT 時 間 ⑥ 西 暦年 











っ 1 


現在 の 日 付 と 時 刻 を 取得 する 





PART Date ク ラス の イン スタ ンス を 作成 する と き に 、 コ ンス トラ クタ に バラ メー タ を 渡さ な いで 作 
成す る と 、 そ の 時 点 で クラ イア ント PC が 持つ 日 時 が Date オ ブ ジ ェクト に 格納 され ます 。 格納 
され る 単位 は ミリ 秒 ま で の 詳細 な も の で す 。Date ク ラス の プロ バテ ィ に より 、 年 か ら ミ リ 秒 ま 
で の 値 を 取り 出す こと で きま す 。 保持 し て いる 日 時 か ら 必 要 な 値 を 取り 出す た め に 、 下 表 の よ 
うな Date ク ラス の プロ バテ ィ を 使用 で きま す 。 





共 Date クラ ス か ら 日 時 を 取得 する た め の プ ロバ ティ 
















































































| 4 桁 の 年 fullYear 2013 | 西暦 2013 年 
月 を 表し ます 。0 か ら 始 まる た め 、 0 が 1 月 を 表し ます 。 | | ]1 | ]2 月 ] 
月 の 日 付 を 表し ます 。 「 「 laae |1 ll 

| 曜日 を 数 値 で 表し ます 。0 が 日 曜日 表し ます 。 dey 6 | 王 コ 

| 時 間 を 0 23 の 数 値 で 表し ます 。 hours | 1 | 生後 7 時 

分 を 0 ~ 59 の 数 値 で 表し ます 。 「 mnutes 。 |3: 150 ター 

| 秒 を 0 ~ 59 の 数 値 で 表し ます 。 | | SeCOnds | 0 | 0 秒 | 























AMPLE ビ ロ DE EE 


日 時 を 設定 する DateSampleB.fla 
/ / 現在 日 時 の 取 和 

var dt:Date = new Date () 

人 演 導 人 ( M も )) 

//trace( dt.vValueOfE() ): 


/ / 特定 の 日 時 を セッ ト す る 

//String で セッ ト ( 2015 年 1 月 1 日 ) 

var dt1:Date = new Date( "01/01/2015" ): 
trace( dt1 ): 


//1970/1/1 00:00 か が か ら の 経過 ミリ 秒 で 指定 
ya dt2:Date = new Date( 1300000000000 ): 


race( dt2 ): 


/ / 年 、 月 、 日 、 時 、 分 、 秒 を それ ぞ れ 指定 (2012/11/31 23:59:59) 


う の 


る こす - メ 々 
現在 の 日 付 と 時 刻 を 取得 する 


Var dt3:Date = new Date( 2012, 11, 31, 23, 59, 59 ): 
trace( dt3 ): 


/ / 年 と 月 の み 指 定 (2013 年 1 月 ) 
Var Qt4:Date = new Date( 2013, 1 ): 
trace( dt4 ): 


1 


Date イ ンス タン ス に 日 時 を 設定 する に は 、 コ ンス トラ クタ に パラ メー タ を 渡し て すべ て 行う 
こと が で きま す 。 い で 行っ て いる よう に バラ メー タ を 渡さ な い 場 合 、Flash Player を 実行 し て 
いる OS の 現在 日 付 時 時 刻 が 設定 され ます 。'2② の よう に 日 まで 指定 し た 場合 、 時 刻 は 0 時 0 分 に 
な り ま す 。 


ぁ 実行 結果 


Sun Apr 18 21:08:43 GMT+0900 2010 
Thu Jan 1 00:00:00 GMT+0900 2015 
Sun Mar 13 16:06:40 GMT+0900 2011 
Mon Dec 31 23:59:59 GMT+0900 2012 
Fr1 FeD 1 00:00:00 GMT+0900 2013 
Sun Apr 18 2010 

Sumn Ap 18 2010 

Sun ACT 18 2010 09:08:43 PM 

Sun ApDr 18 21:08:43 GMT+0900 2010 
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日 付 / 時 刻 の 演算 を 行う 





PART 





っ 和 4 


日 付 の 演算 を 利用 し て 、 例 えば 「 あ る 日 付か ら 30 日 後 ]」 と いう よう な 処理 を 行う こと が で き 
ます 。ActionScript の Date ク ラス で は 、 そ の よう な 日 付 の 加算 や 減算 を 行う こと が で きま す 。 
Date ク ラス の 日 時 デー タ は ミリ 秒 (1 秒 の 1/1000) 単位 で 保持 され て いる た め 、 演 算 に は ミリ 
秒 と の 相互 変換 が 必要 に な り ま す 。Date ク ラス で 日 付 / 時 刻 の 加算 を 行う に は 、 次 の 手順 で 
Date オ ブ ジ ェクト に 日 時 を 加算 し ます 。Date ク ラス で 日 付 / 時 刻 の 加算 を 行う 手順 は 下 表 の よ 
うに な り ま す 。 


軌 Date クラ ス で 日 付 / 時 刻 の 加算 を 行う 手順 


No 作業 内 容 


] 加算 する 日 数 十 時 間 を ミリ 秒 に 変換 する 。 こ こ で 加算 する 日 時 の 単位 に より 、 下 表 日 時 => ミ 
リ 秒 の 変換 公式 .」 の よう な 変換 が 必要 に な り ま す 。 



































1 - 還 
2 Date オ ブ ジ ェクト の getTime() メ ソ ッ ド の 戻り 値 に 上 記 1 の 結果 を 加算 し ます 。 


ーー 











3 2 の 結果 を も と に し て 新しい Date オ ブ ジ ェクト を 作成 する 。 月 叶 莉 丹 で 解説 し た よう に 、Date 
クラ ス の コン スト ラク タ は 1970/1/1 か ら の ミリ 秒 を 日 付 に 変換 し ます 。 














も 日 時 => ミリ 和 の 変 反 式 ーー 


単位 | 変換 (ミリ 秒 に する に は ) 例 
秒 1000 を 掛け ます 50 秒 => 50xX1000 ミ リ 秒 
分 1000X60 を 掛け ます | 5 分 =>5Xx1000X60 ミ リ 秒 


| 時 間 | 1000x60x60 を 掛け ます 3 時 間 => 3x1000x60x60 ミ リ 秒 
日 | 1000x60x60x24 を 掛け ます 10 日 => 10x1000x60x60x24 ミ リ 秒 















































| 週 1000x60x60x24x7 を 掛け ます | 2 週間 => 2X1000X60xX60x24X7 ミ リ 秒 











※ 1 か 月 と 1 年 は 日 数 が 異な る の で 、 公 式 で は 固定 で きま せん 。 


し Date クラ ス の 日 付 / 時 刻 の 演算 を 行う た め の メ ソ ッ ド 詳 細 ー 
メソ ッ ド の 詳細 






getTime() | Date オ ブ ジ ェクト が 持つ 日 時 の 、1970/1/1 0:00 か ら の ミリ 秒 数 (Number) を 返し 


・ NumDer | ます 。 











メー ゴー 六 
日 付 / 時 刻 の 演算 を 行う 





ニー アー 敵 コ 間 mi mjp】 コ 


シン ブル な 日 時 の 加算 DateSampieC.Hla 


/ / 基 準 日 (2011/1/15 11:00) の オブ ジェ クト を 作成 
Yar 8tartDate : Date=new Date(2011,1,15,11,.0,0,0): 


// 1. 加算 する 日 数 + 時 間 (30 日 と 18 時 間 ) を ミリ 秒 に 変換 する 
var plusDateTime : NurmDbe = 一 ーーーーーーーーーーーーーーーーーーーーー-(①) 

0 * 1000*60*60*24*7 + // 週 

30 * 1000*60*60*24 + /』 


18 * 1000*60*60 + / / 時 間 
0 * 1000*60 + が た , 益 
0 * 1000: // 秒 


// 2. Date オ ブ ジ ェクト の getTime ( ) メソ ッ ド の 戻り 値 に 1. の 結果 を 加算 する 


Var newDateNum : Number=8artDate .detTime ( ) +p1usDateTime : 一 一 ーーーーーーーー ②③) 


// 3. 2 の 結果 を も と に し て 新しい Date オ ブ ジ ェクト を 作成 する 
Var newDate :Date=new Date (newDateNum) : 一 一 ーーーーーーーーーーーーーーーーーーーーーーーー ③) 


trace( newDate .toString() ): 


表 「Date ク ラス で 日 付 / 時 刻 の 加算 を 行う 手順 ] を も と に 、 日 数 十 時 間 を Date オ ブ ジ ェクト 
に 追加 し ます 。 こ の 例 で は 、2011 年 1 月 15 日 11 時 0 分 か ら 30 日 と 18 時 間 後 の 日 時 を 算出 し ます 。 

の plusDateTime:Number 変 数 に 加算 する 日 数 十 時 間 の ミリ 秒 換算 値 を 代入 し ます 。② の 
newDateNum:Number 変 数 に 新しい 日 時 の 1970 年 か ら の ミリ 秒 値 が 代入 され ます 。⑬③ で そ 
の 値 か ら 日 時 を 持つ Date オ ブ ジ ェクト を 作成 し ます 。 


> 実行 結果 
Fr+1 Mar 18 05:00:00 GMT+0900 2011 


= ある 2 画 コ 導 mfmlp】 ヨ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


関数 に よる 日 時 加算 処理 DateSampieD.fla 
/ / 基 準 日 (2011/1/15 11:00) の オブ ジェ クト を 作成 

Var 8tartDate :Date=new Date(2011,1,15,11,.0,.0,0): 

var newDate1 :Date = aqdqdDays ( startDate, 30 ): //30 日 を 加算 

var newDate:Date = aqdHourgs ( newDate1, 18 ): //18 時 間 を 加算 


trace( newDate .toStrinq() ): 


うう 


2- 1 
日 付 と 時 刻 


/ / 週 を 加算 する 関数 
Funoction addWeeks (date :Date, weeks :Number) :Date { 
eturn adQDays (date, Week8*7) : 


PART ) 


/ / 日 を 加算 する 関数 
Function addaDays (date :Date, dayg :Number) :Date { 





return addHourgs (date, dayg8*24 ) : 


/ / 時 間 を 加算 する 関数 
DateSampleC.EF1a Function addHours (date :Date, hrg:Number) :Date { 


て eturn addMinutes (date, hrs*60) 


/ / 分 を 加算 する 関数 
Function addMinutes (date : Date, mings:Number) :Date { 


return addSeconds (date, mitng8*60) 


/ / 秒 を 加算 する 関数 

Function addSeconds (date :Date, secg :Number) :Date { 
Ya mSecg8 : NumDe エ =SeC8*1000: 
Ya 8um: Number=mSecs+date .qdetTime () : 


return new Date (sum) : 


手順 2 の 処理 (「Date ク ラス で 日 付 / 時 刻 の 加算 を 行う 手順 ] の No.2) を 毎回 行う の は あま り 効 
率 的 で は あり ませ ん 。 こ の よう な 処理 は 関数 を 作成 し て 行う よう に し ます 。ActionScript リ 
ファ レン ス で も 次 の サン プル に ある よう な 関数 を 例示 し て いま す 。 こ の サン ブル で は 、 上 記 の 
サン プル と 同じ 日 時 を 、 関 数 を 使用 し て 加算 し て いま す 。 


ぁ 実行 結果 


Fr1 Mar 18 05:00:00 GMT+0900 2011 


っ 6 


2 - 2 タイ マー と 経過 時 間 
ロレ 1 の :UE まっ 





日 単位 の 時 間 で は Date ク ラス を 使用 し まし た が 、 秒 、 ミ リ 秒 単位 の 時 間 計測 に つい て は タイ 
マー 制御 関数 を 利用 する と 便利 で す 。ActionScript2.0 で 使用 され る タイ マー 制御 関数 は 
ActionScript3.0 で は flash.util パ バッ ケー ジ に 格納 され て いま す 。 そ の 中 か ら getTimer() 関 数 
を 解説 し ます 。 


圭 ActionScript の タイ マー 制御 関数 



























っ TimerSample swf 
ファ イル (F) 表示 (V) 号 御 (CO デバ ッ グ (D) 






2 回 目 以降 の getTimer() 呼 び 出 し と 1 回 目 呼 び 出 し 時 の 時 間 差 を 計測 し て 表示 する シン プル 
な サン ブル で す 。start_btn と いう Button (開始 ボタ ン ) を 押す こと で 計測 を 開始 し 、stop_ 
btn こ いう Button (計測 ボタ ン ) を 押す ご と に 経過 時 間 を 計算 し て timer_ txt と いう テキ スト 
フィ ー ル ド に 秒 単 位 で 表示 し ます 。 

getTimer() 関 数 を 2 回 実行 し て その 差 を 計算 する と 、1 回 目 と 2 回 目 の 間 の 時 間 間 隔 が 取得 で 
さま す 。 


2 
9 拓 





っ 7 


メー メ 
タイ マー と 経過 時 間 


田 getTimer() を 2 回 実行 し て その 間 の 経過 時 間 を 取得 





gBtTimeT() getTimer() 
PART ei 
1 回目 呼 び 出 し ら 回 目 呼び 出し 


この 時 間 間 隔 を 計算 で 取得 し ます 


AMIPLE ヒロ ロ E EE 


getTimer() 関数 に よる シン ブル 時 間 計 測 TimerSampleAfla 


/ /getTimer 関 数 の イン ポー ト 
1mport FfF1ash .ut ュ 1] 8 .detT1mer: 


/ / ス ター ト 時 間 を 保持 する 変数 
Yar 8tartTime : NumD@er : ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー (① startTime 変数 の 宣言 


/ / ボ タン イベ ント ハン ドラ の 設定 
this .start btn.addEventListener ( MouseEven .CLhTCK, getSEar ): 
this . stop btn.addEventLiistener( MouseEvent .CLTCK, getT1me ): 
Function getStart ( me:MouseEvent ) :void { 
this .t1mer txt.text = "開始 し まし た り : 
/ / 起 動 後 の 時 間 を startT1me に 格納 
gtartTime = detTimer ( ) : -- 一 ーーーーーーーーーーーーーーー②getTimer() 呼び 出し 1 回 目 


) 


Function getTime( me:MouseEvent ) :vo1d { 
Ya dif :Number = qetTimer() - startT1me: ーーーーーーーーーーーー ーーー」 


this .timer txt.text = ( difF / 1000 ) .toString() + " 秒 経過 『: 


や ① で 宣言 し た startTime 変 数 に ② の 1 回 目 の getTimer() の 結果 を 格納 し ます 。3③ で 行っ て い 
る よう に 、2 回 目 以降 の getTimer() 呼 び 出し 時 に 差 を 計算 し ます 。 


っ 8 


タイ マー を 使用 し て 
繰り 返し 処理 を 行う 





ActionScript に よる タイ マー 負 理 の た め に Timer ク ラス が 用 意 さ れ て いま す 。 flash.util. 
Timer ク ラス は 、 指 定 し た 時 間 間 隔 で 処理 を 実行 する た め の タ イマ ー 機 能 を 提供 し ます 。 イ ベ 
ント の 発生 を 開始 する た め に start() メ ソ ッ ド を 実行 し ます 。 こ の イベ ント を 利用 し て 一 定 間隔 WW 
で 繰り 返し 処理 を 行う こと が で きま す 。Timer ク ラス の イン スタ ンス を 作成 する と き に 、 コ ン 
スト ラク タ の バラ メー タ で 時 間 間 隔 (delay) と timer イ ベン ト の 回 数 (repeatCount) を 指定 で 
さま す 。 実際 の タイ マー 処理 は 、Timer オ ブ ジ ェクト の イベ ント を 使用 し て ハン ドラ 内 で 行い 
ます 。Timer ク ラス に は 下 表 の よう な イベ ント が 用 意 さ れ て いま す 。 


ロ Timer ク ラス の 時 間 計 測 用 イベ ン ト 


| イベ ント (下段 は 文字 列 定 数 | 暗 S Re F ーーー 一 









































ba 指定 し た 時 間 間 隔 で 繰り 返し 送出 され ます 。 
| で merEventTIMER | ! 
| 1」 merComp1ete | 指定 し た 回 数 timer イ ベン ト を 発生 させ た 後に 送出 され ます 。 
| TimerEventCOMPLETE | 

















委 Timer ク ラス の 計測 を 制御 する た め の メ ソ ッ ド 詳細 
































| メソ ッ ド メソ ッ ド の 詳細 ] 
Timer ( コン スト ラク タ で す 。 パラメータ で 指定 され た タイ マー 内 容 を 持つ オ 
de1ay : Number , ブ ジ ェクト を 生成 し ます 。 
repeatCount:1nt = 0O | delay:Number timer イ ベン ト を 発生 させ る 時 間 間 隔 を ミリ 秒 で 指定 
し ます 。 


repeatCounttint timer イ ベン ト を 発生 させ る 回 数 を 整数 で 指定 し ます 。| 
指定 し な い 場 合 、timer イ ベン ト は 停止 させ る まで 無限 に 発生 し ます 。 


=tart ( ) : vo1d Timer を 開始 し ます 。 
Timer イ ンス タン ス の 乏 働 を 開始 し て イベ ント を 発生 させ る た め に は 、 
start1U メ ソ ッ ド を 呼び 出す 必要 が あり ます 。 停止 す る に は stop() メ ソ ッ 
ド を 実行 し ます 。 


stop ( ) : void Timer を 終了 し ます 。 
Timer イ ンス タン ス の 稼働 を 停止 する に は stop() メ ソ ッ ド を 実行 し ます 。 | 





















































AMPLE ビ ロ DE EE 


Timer に よる シン ブル な 時 間 計 測 TimerSampieB.fla 
/ /1 秒 で 5 回 イベ ント を 発生 する Timer オ ブ ジ ェクト を 作成 
Va 七 1hmer :T1mer=new Timer(1000,5) : ーーーー ーーー 1 
Var COunt@Gr : 1 ロ ヒ =0 : 


っ ? 


ご 
タイ マー と 経過 時 間 


/ /timer イ ベン トバ ハン ドラ を 設定 
timer .adqdEventTiistener ( T1merEvent .TTIMER, 上 1merL1stener ): 


/ /timerComp1ete イ ベン ト ハ ンド ラ を 設定 

















PART timer . addEventTLiistener ( TimerEvent .TTMER COMPLETE, timerComplete ): 
/ /T1mer を 開始 
1mer . S 上 ar () 』 - ー - (の 
/ / 現在 時 刻 を 取得 し て 表示 
ya 8tar モ :Date = new Dae ( ) : 一 一 ーーーーーーーーーーーーーーーーーー ーー (人 
trace ( "開始 時 刻 :" + start .getHourg () + ":" + gtart.qetMinutes() + "! 『 
+ gtart .qetSeconds() + ".! + gtart .qetM111isecondgs() ): 


Function timerListener( te:T1merEven ) :vo1d { 


trace ( "上 1mer エ イベ ント :" + counter ): 











COum 七 G+ 』 

) 

Function timerComp1ete ( te:TimerEvent ) :void {一 ーーーーー 委 
va end :Date = new Date () : 一 一 一 4 Pr よ 寺 ⑤ 
trace ( "終了 時 刻 :" + end.getHours() + ":" + end.qetMinutes() + "リオ 
end .getSecond8() + "リリ + end .getMi11iseconds() ): 


timer . removeEventTLiistener ( TimerEvent .TTMER, 上 1merL1stener ): 


Timer ク ラス の コン スト ラク タ で 時 間 間 隔 と 繰り 返し 回 数 を 指定 する シン プル な サン ブル で 
す 。 timerComplete イ ベン ト ハ ンド ラ で timer イ ベン ト ハ ンド ラ の 登録 を 解除 し ます (④)。 こ 
の 解除 処理 は サン プル で は 必ず し も 必要 で は あり ませ ん が 、 実際 の アプ リケーション で は リン ソ 
ー ス 節約 や バグ 防止 の た め に も 、 行 う よ う に し まし ょ っ う 。 

の Timer ク ラス コン スト ラク タ で 1000 ミ リ 秒 (1 秒 )、5 回 繰り 返し の 設定 を 行っ て いま す 。 
3 で start() メ ソ ッ ド を 呼び 出し て Timer を 開始 し て いま す 。 こ の 後 1 秒 ご と に timerListener 関 
数 が 呼び 出さ れ ま す 。3③ と ⑤ の Date オ ブ ジ ェクト は 、 開 始 / 終 了 時 刻 を 取得 する た めで す 。 


> 実行 結果 
開始 時 刻 :10:35 50.32 
timer イ ベン ト :0 
timer イ ベン ト :1 
t1imer イ ベン ト :2 
timer イ ベン ト :3 
timer イ ベン ト :4 
終了 時 刻 :10:35 55.36 


60 





3 - 1 数 値 の 処理 
数 値 デ ー タ を 使う 





PART 


62 


ActionScript3.0 で は 数 値 デ ー タ 型 は すべ て クラ ス で 提供 され ます 。 そ の た め 、 数 値 デ ー タ 
は オブ ジェ クト で す 。 し か し 数 値 デ ー タ は 単 一 の 値 を 持つ シン ブル な デー タ で あり 、 数 値 演算 
の 対象 に も な る た め 、Array な どの 複合 型 オ ブ ジ ェクト より も 処理 効率 を 上 げ る た め の 仕 組み 
が 取り 入れ られ て いま す 。 こ の 特殊 な オブ ジェ クト は 「 プ リ ミ テ ィ ブ デ ー タ 型 」 と 呼ば れ 、 
Boolean、int、Number、String、uint が 該当 し ます 。 こ の うち int、Number、uint が 数 値 
デー タ 裂 で す 。 


外 ActionScript3.0 の 数 値 デ ー タ 型 詳細 


プラ ス 、 マ イナ ス の 整数 値 を 格納 で きま す 。ActionScript で は 、32 ビ ピット を 使用 する た め 、 
_-23! > 23-] の 範囲 が 有効 で す 。 こ の 範囲 を 超え る 数 値 か 、 実 数 を 扱う 場合 、Number 型 
を 使用 し ます 。 

値 の 範囲 は intIMIN_VALUE、 intIMAX_VALUE と いう パブ リッ ク 定 数 で も 定義 され て いま す 。 


※ー2?| = ー2.147.483.648 2"ー1 = 2,147,483.647 


Number | プラ ス 、 マ イナ ス の 整数 と 小数 つき の 実数 値 を 格納 で きま す 。64 ビ ピット が 使用 され ます 。 
値 の 範囲 は NumberMAX_VALUE 、Number.MIN_VALUE と いう パブ リッ ク 定 数 で 定義 さ 
れ て いま す 。ActionScript の Number 型 で は 、 例 えば 1/3 と いう 分 数 を 処理 する 場合 な ど 
で は 近似 値 に よる 演算 と な り ま す 。 int、uint の 2 倍 の ビッ ト 数 が 使用 され る た め 、 整 数 の み 


に 使用 する 変数 に つい て は Number 型 の 使用 は 避け た ほう か 実行 効率 が 上 が り ま す 。 


プラ ス の 整数 値 を 格納 で きま す 。int 型 と 同様 に 32 ビ ッ ト し ます 。 int 型 と 異な り マ イナ ス 値 
を 扱え な い 代わ り に 、 扱 える プラ ス 数 値 の 範囲 が 約 2 の 倍 に な り ま す 。0~ 2“ -1 の 範囲 に 使 
用 で きま す 。uint の u は 、unsigned (符号 な し ) を 意味 し ます 。 値 の 範囲 は uint.MIN_VA 
LUE、uint.MAX_VALUE と いう パブ リッ ク 定 数 で も 定義 され て いま す 。 


※2 デ ー1 = 4.294.967.295 





yar intData : int = initia1Value:  // new と コン スト ラク タ を 省 賠 
ya intData : int = new int( initia1Va1ue ) : //new と コン スト ラク タ を 使用 


ActionScrip3.0 の 数 値 デ ー タ 型 は クラ ス で 提供 され ます が 、 変 数 宣言 と イン スタ ンス の 生成 
に new 演 算 子 と コン スト ラク タ は 使用 し て も 、 し な く て も か まい ませ ん 。 ト 下記 の 2 つの int 型 変 
数 の 宣言 と 初期 化 は 全く 同じ で す 。initValue は 整数 値 を 表し ます 。 


E24 に レネ か コノ た まっ ほ オ w 有 ま っ) 





| 数値 デ ー タ を 使う ] で 解説 し た よう に 、ActionScript3.0 で は 数 値 デ ー タ 型 は すべ て 
クラ ス で 提供 され る た め 、 数 値 デ ー タ 自体 の メソ ッ ド を 使用 で きま す 。 int、Number、uint 
昔 ク ラス に 共通 する メソ ッ ド が 提供 され て お り 、 そ れ ら を 使用 し て 書式 の 変換 を 行う こと が で 
さま す 。 メ ソ ッ ド と 用 途 を 下記 の 表 に まとめ ます 。 


径 ActionScript3.0 数 値 デ ー タ クラ ス の 主 な 共通 メソ ッ ド 


指数 表現 toExponent1a1 数 値 デ ー タ の 指数 表現 形式 を 作成 し ます 。 指数 表現 
Fract1onD1gd1tg:u1nE | と は 、9.99e+3 の よう な 表現 で 、e+3 は 「x10*」 を 
: Str1nd 表し ます 。 つ まり 9990 と 同値 で す 。 9.99e-3 の よ 
うに マイ ナス が つく 場合 は 「x10“」 を 表し 、 こ の 
場合 0.00999 と 同値 に な り ま す 。 

パラ メー タ の fractionDigits は 小数 点 以下 の 桁 数 を 
表し 、0 以 上 20 以 下 ま で 指定 で きま す 。 


























固定 小数 点 表 現 | toFixed! 






小数 点 以 下 の 桁 数 を 指定 の 長 さ に し た 形式 を 作成 し 
Fract1onD1gitgs:u1inE | ます 。 実際 の 桁 数 が 指定 し た 長 さ より 長い 場合 、 切 
) :String り 捨 て られ 、 短 い 場 合 は 0 が 挿入 され ます 。 






パラ メー タ の fractionDigits で 小数 点 以 下 の 桁 数 を 
指定 し ます 。 



















桁 数 指定 ヒ OP エ GC181OT ( 指定 し た 桁 数 で 数 値 を 表記 し ます 。 指 数 表現 が 必要 
DrecC181On : u1n ヒ な 場合 、 作 成 さ れ ま す 。 
: String パラ メー タ の precision で 全体 の 桁 数 を 指定 し ます 。 













2 進 ~- 36 進 数 表記 数 値 の スト リン グ 表 現 形 式 を 作成 し ます 。 
パラメータ の radix で 基数 (進数 ) を 指定 で きま す 。 
デフ ォ ル ト 値 が 10 な の で 、 指 定 し な い 場 合 10 進 数 


の 表記 と な り ま す 。 







上 OS 上 了 ュ nd ( 
rad1x :Numbper = 10 
:S キ 1nq 














に MM 妥 表 = 埋 四 mp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


数 個 の 耕 本 的 な 書式 変換 NumbersSample.fla 


VaY 1:1n = -101: 


Var n:Numper = 123.4567: 


Var U1:u1nE = 1001: 


/ /toStrindg ( ) 

trace( 『-EoStrinq ( 10 ) :10 進 表記 ----  ): 

も 8CG( "> 大 = NR + すま も OGKFHM 10 うす) 

tracCe( "nz:Numper = " + n.toStrinq( 10 ) ): 
も と AOG( "UE :U1 せ JE = 『 よ dL.EQOSEYSPG( 130 ) )。 


/ /toExponentia] () 
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き - 1 
数 値 の 処理 


trace ( "-toExponentia] ( 2 ) : 小数 点 以 下 2 杵 の 指数 表現 ---- " ): 
trace( 1.toExponentia1( 2 ) ): 


trace( n.toExponentia1( 2 ) ): 





trace( ui.toExponentia1( 2 ) ): 
/ /toFixed ( ) 

trace( "-EoFixed ( 2 ) : 小数 点 以 下 2 桁 の 固定 小数 点 表 現 ---- " )』 
trace( 1.toFixed( 2 ) ): 


trace( n.toFixed( 2 ) ): 





trace( ui.toFixed( 2 ) ): 
//toPreoigion ( ) 

trace( "-toPreocision ( 2 ) : 2 桁 の 桁 数 指定 ---- " ): 
trace( 1.toPreoision( 2 ) ): 

trace( n.toPreocisgsion( 2 ) ): 


trace( ui.toPreocisgsion( 2 ) ): 


int、Number、uint の 各 オ ブ ジ ェクト に つい て 、 共 通 の メソ ッ ド に よる 書式 表現 を 確認 す 
る サン プル で す 。 

① で 、toString(10) に より 10 進数 に 変換 し た 値 を 出力 し て いま す 。② が toExponential() に 
よる 指数 表現 、③ が toFixed() に よる 固定 小数 点 表 現 、④ が toPrecision() に よる 全体 桁 数 指定 
の 表現 で す 。 


実行 結果 
- も OS て ng ( 10 ) :10 進 表記 ---- 
1:int = -101 


n : NumDer = 123.4567 

ut:u1nE = 1001 

-toExxponentia] ( 2 ) : 小数 点 以 下 2 杵 の 指数 表現 -- - - 
- ユ 。 0 よら G+2 

1 .23@+2 

1 .00@+3 ぅ 3 

-toFixed ( 2 ) : 小数 点 以 下 2 桁 の 固定 小数 点 表 現 - - - - 
-101.00 

123.46 

1001.00 

-toPreoision ( 2 ) : 2 桁 の 桁 数 指定 ---- 

- ユ 0@+2 

1 .2e+2 

1 .0@+3 





ActionScript3.0 で sin() な どの 数 学 的 な 関数 や な の よう な 定数 を 使う 場合 、Math ク ラス を 
使用 し ます 。 こ の クラ ス の メン ババ (プロパ ティ と メソ ッ ド ) は すべ て static ( 静 的 ) で す 。static 
で ある と いう こと は 、 new Math() の よう に イン スタ ンス を 生成 し な く て も Math.sin() の よう 
に クラ ス 名 で アク セス で きる こと を 意味 し ます 。 必 要 な と き に 関数 や 定数 を 手軽 に 利用 で きる 
わけ で す 。Math ク ラス の メソ ッ ド や 定数 の 呼び 出し は 、 下 記 の よう に 行い ます 。 


Math クラ ス の プロ パテ イィ と メソ ッ ド の 呼び 出し 構文 


Math .method( parameter ): // Math ク ラス の メソ ッ ド 呼び 出し 
Math .constant //Math ク ラス の プロ パテ ィ (定数 ) へ の アク セス 


鐵 Math クラ ス の 主 な 定数 プロ バテ ィ 


自然 対数 の 底 E:Number 





PINumbDer 








乱 Math クラ ス の 一 般 的 な 数 学 処 理 の た め の メ ソ ッ ド 


Va : NumDer 
) ・ NumDGer 


小数 点 切 り 上 げ Cei] ( Val の 小数 点 を Cell( 9.5 ) 
Va1 : Number 切り 上 げた 値 
) : NumDe エ 


小数 点 切 り 下 げ F1oor ( val の 小数 点 を floor( 9.5 ) 
Va : NumDer 切り 下げ た 値 
) : NumDer 





max ( パラ メー タ の 中 で | max( 1.2, 1.0, 1.3) 
Y1 : Number, 最大 の 値 

V2 : NumDer, . . 

) : NumDe 了 


min ( パラ メー タ の 中 で | min( 1.2, 1.0, 1.3) 
Y1 : NumDber , 最小 の 値 

V2 : NumDer, . . 

) : NumDer 
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3- 1 
数 値 の 処理 


徐 Math クラ ス の 一 般 的 な 数 学 処理 の た め の メ ソ ッ ド (続き ) 


目的 メソ ッ ド メソ ゾ ッ ド の サン プル 式 サン プル 
戻り 値 式 の 結果 
2 : NumDer 


累乗 (べき ) v1 を v2 乗 し た 値 | pow( 3.2 ) 
) : NumDe エ 
ラン ダム な 数 random ( ) 0 以上 1 未満 の random() 乱数 
: Number ラン ダム な 数 値 













pOw ( 
1 : NumDber , 






















roOund ( 
Ya : NumDer 
) : NumDer 


四捨五入 val を 四 捨 五 入 し | val( 3.45 ) 
た 整数 値 
ーー 










qr ( 
Va : NumDber 
) : NumlDer 








fl.controls.NumericStepper コ ン ポ ボー ネン ト を 使用 する サン プル で す 。NumericStepper 
で 選択 する 半径 の 値 を も と に 、pow() 関 数 と 円 周 率 を 表す Math.PI 定 数 を 使用 し て 和 面積 を 計算 
し ます 。 





弓 へ MPLE ヒロ ビ ロ E EEE 


半径 の 値 を も と に 面積 を 計算 する MathSample.fla 
どら XXE .EeX ヒ = 07』 
/ /NumerioStepper が 変化 し た と き getArea 関 数 を 呼び 出し ます 
r ns.addEventListener ( Event .CHANGE, qetArea ): 
Function getArea ( event :Event ) :vo1d { 
/ /NumericStepper の 値 と Math . PT 定数 に より 面積 を 計算 し ます 
area も xt.tex モ t = ( Math.pow( r n8.value, 2 ) * Math.PT ) .toStrimd() : 


) 


アタ し に モ ゴ ) を まっ 





Flash ア プリ ケー ショ ン で お みく じ や 抽選 を 行う 場合 な ど に 必要 と な る の が ラン ダム な 数 値 
の 生成 で す 。 ラ ンダ ム な 数 値 は Math ク ラス の random()0 メ ソ ッ ド に より 生成 で きま す 。Math 
クラ ス の 数 学 関数 と 定数 は すべ て static 属 性 で 提供 され る た め 、 イ ンス タン ス を 生成 する こと 
な くそ れ ら を 使う こと が で きま す 。 1 


生 Math ク ラス の ラン ダム な 数 値 を 発生 する た め の メ ソ ッ ド 
| メソ ッ ド メソ ッ ド の 詳細 


| random ( ) :Number 0 以上 1 未満 の ラン ダム な 数 値 を 返し ます 。 こ の メソ ッ ド が 生成 する 数 値 
| は 計算 式 に より 算出 され て いる た め 、 人 が サイ コロ を 振る と き の よ うに 


完全 な ラン ダム 値 で は な く 疑似 乱数 」 と 呼ば れ ま す 。 





= 上 = 才 本 m】 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


0 以上 100 以 下 の ラ ンダ ム な 数 値 発生 させ る MathRandemSample.fla 


Var 」ot : NumDer : 
trace ( "乱数 を 使用 し た くじ 引き を 開始 し ます 『) : 
#O も = 草 あ ER YASGOm() * き 100, 一 一 ーーー デ ーーーー ィ ョ コト NqMu コ 9 ゆ 
1o 上 = Math.Ce11( 1o ) : 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ②) 
tracCe ( "結末 を 発表 し ます 。" ) : 
まま 10 も >m 80 ) { 
trace ( "当たり で す ! 点数 は " + 1ot + 『 点 で し た 。『) : 
) e1se { 
trace ( "は ずれ で す 。 点数 は " + 1ot + 『 点 で し た 。『) : 


random() メ ソ ッ ド は 1 未満 の 数 を 返す の で 、 使 用 する 目的 に 応じ て 整数 化す る な どの 処理 を 
行い ます 。 個 の サン プル で は 、0 以 上 100 以 下 の 整 数 を 算出 し て 80 以 上 で は 当たり 、80 未 満 で 
は は ずれ と し て いま す 。 

の 計算 で lot 変 数 に は 0 以上 100 未 満 の 値 が 格納 され ます 。② の ceil() 関 数 で 小数 切り 上 げ を 
行い 整数 化し て いま す 。 


> 実行 結果 
乱数 を 使用 し た くじ 引き を 開始 し ます 
結果 を 発表 し ます 。 
当たり で す ! 点数 は 87 点 で し た 。 
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四捨五入 や 小数 の 切り 捨て 、 
切り 上 げ を 行う 





PART Flash ア プリ ケー ショ ン で ロー ド さ れ た SWF フ ァイル の パー セン テー ジ を 算出 する と き な ど 、 
小数 点 以下 の 数 値 を 切り 捨て た り 四 捨 五 信 する 、 と いう よう な いわ ゆる | 数 値 を 丸め る 」 処理 の 
必要 性 が 出 て きま す 。 数 値 の 丸め 処理 は Math ク ラス に 用 意 さ ご され た メソ ッ ド で 行う こと が で き 
ます 。 

等 Math クラ ス の 四 搭 五 入 、 小 数 切 り 捨て / 切 り 上 げ を 行う た め の メ ソ ッ ド 詳細 
メソ ッ ド メソ ッ ド の 詳細 
va1 :Number ) :Number | パラ メー タ で 与え られ る 数 値 (val) を 、 そ の 数 値 以上 の も っ と 
も 近い 整数 に 切り 上 げた 値 を 返し ます 。 


F ] oor( Va1 :Number ) :Number | パラ メー タ で 与え られ る 数 値 (Val を 、 そ の 数 値 以下 の も っ と 
も 近い 整数 に 切り 下げ た 値 を 返し ます 。 


Found ( va1 :Number ) :Number | パラ メー タ で 与え られ る 数 値 (val) を 、 も っ と も 近い 整数 に 四 
捨 五 人 し た 値 を 返し ます 。2 つ の 整数 値 の ちょ うど 中 間 に あ る 
場合 、 大 きい ほう の 整数 に 切り 上 げ ら れ ま す 。 



































AMIPLE ヒロ DE 還 EEEEEEEEEEEEEEEE 


数 値 を 丸め る 星 本 処理 MathRoundSample.fla 
Ya mum1 : NumDber = 1.499: 
Ya num2:Numlbe エ = 1.5: 一 一 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー① 


Va num3 :Numper = 1.501: 

traCe ( "num1="+num1+", mum2="+nmUum2+" , mum3= リ +mUm3 ): 

trace ( "cei1 メ ゾ ソ ッ ド に よる 切り 上 げ : 『" + "num1 ="+Math . Ce11 (mum1) +『/ 
num2="+Math . Cei1 (num2 ) +", num3=" リ +Math . Cei] (num3) ): 

trace( "FE]1oor メ ソ ッ ド に よる 切り 下げ : 『" + "mum1="+Math . Foor (num1 ) +『 , 
num2="+Math . Eoor (num2 ) +", num3="+Math .F1oor (mum3) ): 

trace ( "round メゾ ソ ッ ド に よる 四 捨 五 人 : ! + "num1="+Math . round (num1 ) +『 , 
num2="+Math . round (num2 ) +", num3="+Math . round (num3) ): 

trace ( "マイ ナス 値 の 処理 で す " ): 


mum1 = -1.499: 

YU2 = ョ =ー よ ま 。5: 

mum3 = -1.501: 

trace ( "num1=" + num1 + ", num2=" 二 num2+" num3=" 二 mum3 ): 


trace ( "Cell メソッド に よる 切り 上 げ : " + "num1="+Math . Ce] (num1) + 『, 
num2="+Math . cei] (num2) + ",num3=" + Math .cCe11 (num3) ): 


trace ( "fF]1oor ャ メソッド に よる 切り 下げ : 『" + "mum1="+Math .F]1oor (num1 ) +『!/ 
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3- 1-5 
四 捨 五 入 や 小数 の 切り 捨て 、 切 り 上 げ を 行う 





四捨五入 や 切り 捨て 、 切 り 上 げ 処 理 で 勘違い し や すい の が マイ ナス 値 の 処理 で す 。 サ ンプ ル 
で は マイ ナス 値 の 処理 も 含め て いま す 。 

の num2 に 設定 し た 1.5 と いう 数 値 は 1 と 2 の ちょ うど 中 間 に な る た め 、round メ ソ ッ ド の 
仕様 通り 、 切 り 上 げ が 行わ れ て いま す 。 そ の 際 、 マ イナ ス 値 (一 1.5) の 場合 結果 は ーー 1 に な り ま 
す 。 


y 実行 結果 
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4- 1 配列 
イン デック ス 配 列 を 使う 





PART 


7Z 


ActionScript で 配列 を 扱う 場合 、 下 表 「ActionScript3.0 配 列 の 種類 と 使用 する クラ ス 」 に あ 
る よう に 、 イ ン デ ックス 配列 と 結合 配列 が あり 、 使 用 する クラ ス も 違う も の に な り ま す 。 イ ン 
デック ス 配 列 は 0 か ら 始 まる 整数 イン デック ス で 要素 を 管理 し 、 結 合 配列 は 数 値 で は な ぐ く 文字 
列 や オブ ジェ クト を キー と し ます 。 表 に ある よう に 、 イ ン デ ックス 配列 は Array ク ラス を 使用 
し て 操作 し ます 。 こ こ で は Array ク ラス に よる イン デック ス 配 列 の 操作 を 解説 し ます 。 


ActionScript3.0 配列 の 種類 と 使用 する クラ ス 


配列 の 種類 内 容 クラ ス 
イン デック ス 配 列 | 先頭 の 要素 が 0 で 始ま る 整数 の イン デック ス で 要素 を 管理 す | Array 
る 一 般 的 な 配列 で す 。 


結合 配列 スト リン グ 値 を キー (要素 を 識別 する 値 ) と する 結合 配列 を 作 | Object 
成 で きま す 。 


任意 の デー タ 型 を キー と する 結合 配列 を 作成 で きま す 。 Dictionary 














イン デック ス 配 列 の Array オ ブ ジ ェクト を 作成 する に は 、 下 表 の よう な 方 法 が あり ます 。 


mm イン デック ス 配 列 の Array オブ ジェ クト を 作成 する 方 法 






var ar:Array = [ "要素 0", "要素 1". "要素 2" ]: 
trace( ar ): // 要素 0, 要素 1, 要素 2 


var ar:Array = new Array( "要素 0", "要素 1", "要素 2): 
trace( ar ): // 要素 0, 要素 1, 要素 2 


var ar:Array = new Array( 3 ):, // 要 素数 =3 の 配列 を 作成 し ます 。 
ar[ 1 ] = "要素 1": //2 番 目 の 要素 に 値 を セッ ト 
trace( ar ): //, 要 素 1 


var ar:Array = new Array(): // 要 素数 =0O の 配列 を 作成 し ます 。 
arpush( "要素 1" ): 
trace( ar ): // 要素 1 



















コッ スト ラク タ や 
要素 の み を 確保 する 















配列 の 要素 数 を 示す 整数 値 で す 。 要 素 が な い 配 列 の 場合 、 
0 に な り ま す 。 





4-1-1 
イン テッ クス 配列 を 使う 


きき Array ク ラス の イン デック ス 処 理 の た め の 主 な メソ ッ ド 


る 












フィ ルター を か ける F11ter Boolean 値 を 返す 関数 を 作成 し て 、 そ の 関数 が true を 返 
す 値 を 要素 と し て 持つ 新しい 配列 を 返し ます 。 

各 要 素 に 対し て 関数 を 実行 関数 を 作成 し て 配列 の 各 要 素 に 対し て 実行 で きま す 。 

wm 


最後 の 要素 を 取り 出し て 削 配列 の 最後 の 要素 を 削除 し ます 。 メ ソ ッ ド の 戻り 値 で そ 
除 する の 要素 が 返さ れ ま す 。 配列 の 要素 数 (length) は 減少 し ま 
す 。 














最後 に 要素 を 追加 する Dugh 要素 を 配列 の 未 尾 に 追加 し ます 。 配列 の 要素 数 (length) 


は 増加 し ます 。 


要素 の 並び を 反転 させ る 先頭 か ら 未 尾 の 並び 順 を 反転 させ ます 。 


先頭 の 要素 を 取り 出し て 削 | shift 配列 の 先頭 の 要素 を 削除 し ます 。 メソ ッ ド の 戻り 値 で その 
除 す る 要素 が 返さ れ ま す 。 配列 の 要素 数 (length) は 減少 し ます 。 
ソー ト す る 8Or 


要素 を Unicode 値 に より 昇順 ソー ト し ます 。 ア ルフ ァ 
ベッ ト で は 大 文字 - 小 文字 の 順に な り ま す 。 比較 を 行う た 
め の 独 自 の 関数 を 作成 する こと も で きま す 。 


要素 を 追加 / 削 除 す る 先頭 の イン デック ス と 要素 数 を 指定 し て 配列 の 要素 を 師 

















加 / 削 除 で きま す 。 


先頭 に 要素 を 追加 する unsh1tt | 要素 を 配列 の 先頭 に 追加 し ます 。 配列 の 要素 数 (length) 
は 増加 し ます 。 


要素 を すべ て 文字 列 に する 配列 内 の 要素 を 「.」 で 区 切ら れ た 文字 列 で 返し ます 。 








= ぬ 妥 前 = 才 aime】 コ 粒 --- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


旦 本 的 な イン デック ス 配 列 の 処理 ArraySampjeA.fla 


Var ar:Array = [ "要素 0", "要素 1", "要素 2" ]: / / オ ブ ジ ェクト の 作成 
trace( ar ):  // 要素 0, 要素 1, 要素 2 
trace( ar.1ength ) , // 3 

/ / 未 尾 に 要素 を 追加 

ar .push( "要素 3" ): 

trace( ar ):  // 要素 0, 要素 1, 要素 2, 要素 3 
trace( ar.1ength ): // 4 

/ / 先頭 の 要素 を 削除 

Var 8:Str1nmqd = ar.8hif() : 

traoe( ar ): // 要素 1, 要素 2, 要素 3 
trace( ar.]ength ): // 3 

/ / 並 び 順 を 逆転 

ar . TGVer8e ( ) : 

trace( ar ) : // 要素 3, 要素 2, 要素 1 
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PART 
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4-1 
配列 


が た ソー ト 
aY . SO ( ) : 
trace( ar ) : // 要素 1, 要素 2, 要素 3 


length プ ロ パ ティ と 基本 的 な メソ ッ ド を 使用 し て いま す 。 trace() 関 数 に 配列 オブ ジェ クト 
を 渡す こと で 、toString() メ ソ ッ ド が 呼び 出さ れ て すべ て の 要素 を 出力 で きま す 。 


> 実行 結果 

要素 0 , 要素 , 要素 2 

き 3 

要素 0 , 要素 1 , 要素 2 , 要素 3 
4 

要素 1 , 要素 2 , 要素 3 

3 

要素 3 , 要素 2 , 要素 1 

要素 1 , 要素 2 , 要素 3 


一 イン デック ス 配 列 と 結合 配列 の 違い 


0 か ら 始ま る 整数 の イン 文字 列 や オブ ジェ クト を 
デック ス 番号 で 要素 を 管 キー (要素 を 識別 する 
イン デック ス 配 列 | 理 する 一 般 的 な 配列 値 ) と する 配列 。 


の 文字 列 を キー と する 場 
。 合 、 配 列 内 の 各 要 素 は 
^] “キー スト リン グ " / 値 と い 


う ペ ア で 格納 され る 


ルル レス トコ ッ 





整数 値 で 配列 の 要素 を 識別 する イン デック ス 配 列 だ け で は な く 、 文 字 列 や オブ ジェ クト を キ 
ー と する 結合 配列 を 作成 で きま す 。 こ こ で は 文字 列 を キー と する 結合 配列 の 作成 方 法 と 操作 を 
解説 し ます 。 文 字 列 を キー と する 場合 、 配 列 内 の 各 要 素 は "キー ス トリ ング " / 値 と いう ペア で 
格納 され ます 。 こ の 配列 を 作成 する の に も っ と も 適切 な の が Object ク ラス で す 。 つ まり 、 結 合 
配列 は 通常 Object ク ラス の イン スタ ンス で す 。 こ れ は Object ク ラス が も っ と も シン プル な 


dynamic ク ラス で ある た めで す 。 


W 結合 配列 を 作成 する 方 法 


ーーーーーーーー 











方 法 サン プル 3 2 





] オプ ジェ クト リテラ ル に | var myCar:Object = { type:"sports", price:400 ]: 
よる 初期 化 


動 的 に 要素 を 追加 var myCar:Object = new Object(: 
| myCartype = "sports": 
| myCar「'price] = 400 





























四 文字 列 を キー と する 結合 配列 を 処理 する た め の Action Script 演 算 子 


人 シィ ャ ーー ャ ルル 有 



































| 」 [ ] 内 に キー 値 を 指定 する こと に より 、 結 合 配 列 の 要素 に | obj["key]= 値 : 
括弧 演算 子 | アク セ ズ で きま すず す 。 trace(obj["key]): 
ドッ ト 演 算 子 | . を 使用 し て キー 指定 する こと に より 、 結 合 配列 の 要素 に | objkey = 値 : 
アク セス で きま す 。 trace(obj.key): 」 











に ね 妥 肖 = 才 四 mg】 蘭 0 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


旦 本 的 な 結合 配列 の 処理 ArraySamnleB.fia 
/ / オ ブ ジ ェクト リテラ ル に よる 結合 配列 の 生成 
var myCar:Ob]ject = { type:"sports", prioe:400 }: 


EraCe( myCar[ "type"] , myCar["price"] ): // sports 400 一 ①| ] 演 算 子 に よる 
人 要素 へ の アク セス 

/ / 動 的 プロ パテ ィ と し て キー と 要素 を 追加 

Var YOurCar :Ob]ect = new Ob]ect () : 

YOUYCar .EYDe = "4wd": 一 一 ーーーーーーーーーーーーーーーー ⑳ 動 的 プロ パテ ィ と し て 要素 を 追加 








③[ ] 演 算 子 に よる 要素 へ の アク セス 


(〈④ ド ッ ト 演 算 子 に よる 
要素 の 取り 出し 


YOurCar [ "Dr1ice"] = 450: 





traCe ( YourCar .t 上 ype, YourCar .price ):  // 4wd 450 


『*- 


配列 に フィ ルター を か が ける 
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配列 内 の 要素 1 つ 1 つ に 対し て 関数 を 実行 し 、 条 件 に 合う 要素 の み を 抽出 し て 新しい 配列 を 作 
成 で きま す 。 こ の よう な 処理 は フィ ルター と 呼ば れ 、Array ク ラス の filter0 メ ソ ッ ド が 用 意 さ 
れ て いま す 。 こ の メソ ッ ド に 自作 の 関数 を 指定 し ます 。 こ の 関数 に は 、 下 記 の 書式 の よう に 
要素 の 値 が 渡さ れ 、 関 数 が true を 返す 要素 の み が 新 し い 配 列 と し て filter() メ ソ ッ ド の 戻り 値 に 
各 ま れ ま す 。 元 の 配列 は 変化 し ませ ん 。 



























































| て 
メソ ッ ド | メソ ッ ド の 詳細 
F1] 上 en 5 callback : 配列 | 内 の 各 要素 に 対し て 実行 され る 関数 を 指 定 し ます 。 こ 
ca] 1back : Function , の 関数 が true を 返す 要素 が 新しい 配列 に 格納 され て メソ ッ ド の 戻り 値 | 
thisOb]ect:* = nu]1 に な り ま す 。 

| ) :Array | thisObject : 関数 内 で this を 使用 し た と き に 参照 れる オブ ジェ クト | 

を 指定 で きま す 。 デ フォ ルト 値 =null な の で 、 指 定 する 必要 の な い 場 | 
は 使用 し ませ ん 。 
きき Array ク ラス の filter() メソ ッ ド に 指定 する 関数 の 書式 

| 関数 関数 の 詳細 

| Eunction ca11back | item : 配列 内 の 要素 で す 。 この 要素 の 値 に 対し て 関数 内 で : 算 や 判 | 
1tem:* , 定 を 行い 、true を 返す 要素 が 抽出 され ます 。 
1index : 1 ロト , index : item の 、 配 列 内 で の イン デック ス で す 。 
a エ エ ray : A エ エ aY array : filter() メ ソ ッ ド を 実行 する Array オ プ ジ ェ クト で す 。 

) : BOO 上 eaT : 














らら AMPLE じ ロロ DE EEEEEEREEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEHEEEE 


Array クラ ス の filter() メソ ッ ド を 使 つ ArraVSainhie む la 
/ / イ ン デ ックス 配列 オブ ジェ クト の 作成 
Yar 8udent sg : A エ エ aY = new Ar エ aY() 


studentg .push( {1 name: "山田 一 郎 ", score: 88 


8tudent8 .Du8h name : "鈴木 二郎", score: 78 


name : "宮田 三郎 ", gcore: 44 


8tudent8g . pugh ( 
students .push ( 
( 


name : " 三 輸 彰 夫 ", score: 63 


ーー ンー 。 ーー ニー 一 ニー 一 トー 


( 
1 name : " 須 膝 俊一 ", score: 25 
( 

students .push( 1 


//fi1ter ( ) メソ ゾ ッ ド の 実行 と 出力 


var doukaku :Array = 8Eudentg . 上 FE11Eer( SCoreF1lter ): 


4-1-3 
配列 に フィ ルター を か が ける 


For ( var 1:int = 0 : 1 < goukaku.1ength : 1++ ) { 
trace( goukaku[ 1 ] .name + 『" ぎ て 点数 :" + goukaku[ 1 ] .score ): 


) 


//fi1ter 関 数 

FuncCt1ion SCoreF11ter( gtudent :*, 1ndex : int , ary:Array ) :Boo]ean { 
if ( sgtudent . score >= 60 ) return true:  //score が 60 以 上 の 場合 、 結 果 に 含 
AO か の 


elge return falge: 





で は イン デック ス 配 列 students に 要素 を 追加 し て いま す 。 要素 の 値 の 記述 は 次 の よう に 
な っ て お り 、 こ れ に より 難 要素 は name、 お よび score と いう プロ パテ ィ を 持つ Object 型 の 値 
を 持つ よう に な り ま す 。 


{ name : "山田 一 郎 ", score:88 } 
この よう に Object ク ラス の イン スタ ンス は 、 
{ プロ パテ ィ 1: 値 1 プロ パテ ィ 2: 値 2 .…) 
と いう 書式 で 生成 で きま す 。 
@ で fter(0 メ ソ ッ ド を 実行 し て scoreFilter と いう 関数 名 を 指定 し て いま す 。 
3 が scoreFilter 関 数 で 、student:* と いう パラ メー タ に 配列 の 各 要 素 が 渡さ れ て 繰り 返し 実行 
され ます 。④ で 要素 内 の score プ ロ パ ティ の 値 が 80 以 上 の 場合 に true を 返し て いま す 。 
ぁ 実行 結果 
山田 一 郎 点数 : 88 


鈴木 二郎 点数 :78 
三輪 彰夫 点数 :63 


7/ 


4 Dictionary に よる 結合 配列 を 使う 





PART ActionScript3.0 で は 、Dictionary ク ラス を 使用 し て 、 オ ブ ジ ェクト を キー と する 結合 配列 
を 作成 で きま す 。 オ ブ ジ ェクト を キー と する 場合 、Dictionary イ ンス タン ス が 結合 配列 オブ 
ジェ クト と な り 、 配 列 内 の 各 要 素 は 、 オ ブ ジ ェクト / 値 と いう ペア で 格納 され ます 。Dictionary 
に よる 結合 配列 を 作成 する 場合 、 下 記 の よう に 、[] (演算 子 ) を 使用 し て 結合 配列 の 要素 に アク 
セス で きま す 。 


邊 オブ ジェ ク ト を キー と する 結合 配列 を 処理 する た め の ActionScript 演 算 子 


ニニ ーー ーーーーーーーーーーーーーーーーーーー コ 
| 




















| 演算 子 説明 例 
[] [ ] 内 に キー 値 を 指定 する こと に より 、 結 合 配列 の 要素 に | obilkeyobll= 値 


| 括弧 演算 子 アク セス で きま す 。 | trace(objlkeyobil): 


AMPLE ビ ロ DE EEEEEEEEEEEEEEEEEEEEE 


Dictionary に よる 結 台 配列 を 作成 する ArraySafHpie.fla 











1mport Flash .ut 上 118 .D1Ct1OnaryY : 


Yar da:Diotionary = new D1Ct 上 1onarY () : 


var key1 : B1tmap = new Btmap() : 


var key2 : Camera = new Camera () : 


ーー エーーーーー 一 つ 
ー ム 


Var key3 :Date = new Date () : 


パ 吉 あま >: 和 APAV ーー すま 0P。 20W 1 
Var Va12 :8S エ ュ 1nd = "ABCP: 
var Va13:Ob]ect = new Ob]ect () : 


da [key1] = Ya11: | 
da [key2] = Ya12: | 5 
da [key3] 


Ya1 3 


trace( da[key1]  ): 
trace( da[key2]  ): 
trace( da[key3]  ): 


で 作成 し て いる オブ ジェ クト が 、Dictionary 配 列 の キー と な る も の で す 。② で それ ら の キ 
ー を 使用 し て 、 結 合 配 列 に 値 を 格納 し て いま す 。 
8 


4 - 2 ベク ター 





ActionScript の 配列 に は デー タ 型 の 異な る オブ ジェ クト を 格納 で きま す が 、Vector ク ラス を 
使用 する ベク ター と 呼ば れる 配列 は 、 同 じ デ ー タ 型 で 構成 し ます 。 そ の 目的 は デー タ 型 の 統一 
に よる 処理 の 効率 化 と 整合 性 の 確保 で す 。 有 要素 が みな 同じ デー タ 型 で ある た め 、 ア クセ ス が 
Array よ り も 高速 に で きる こと が その 理由 で す 。 ま た 、Vector オ ブ ジ ェクト を 作成 する と き に 
テー タ 型 を 決定 する た め 、 そ の デー タ 型 以外 の 要素 は 格納 で き な く な り ま す 。 指定 し た デー タ 
型 は 「 ベ ー ス 型 」 と 呼ば れ ま す 。Vector ク ラス の メソ ッ ド と プロ パテ ィ は Array ク ラス と 類似 し 
て いま す 。Vector ク ラス の オブ ジェ クト を 作成 する 場合 、 下 表 の 2 つの 方 法 が あり ます 。 


am Vector ク ラス の オブ ジェ クト を 作成 する 方 法 


Vector() グ ロー バル 関数 で | var vt:Vector.<T>=Vector.<T>( arrayT ): 
Array を 変換 し て 初期 化 // T は ベー ス 型 を 表す ActionScript デ ー タ 型 。arrayT は 要素 の 
デー タ 型 すべ て T の 配列 


Vector ク ラス の メソ ッ ド で | var vt:Vector<T>: // T は ベー ス 型 を 表す ActionScript デ ー タ 型 
要素 を 追加 vV = new Vector<T>(): // イ ンス タン ス の 生成 
vV.push( itemrT ): //push メ ソ ッ ド で 要素 を 追加 





mm ベク ター を 処理 する た め の ActionScript 演 算 子 


[」 [ ] 内 に イン デック ス 値 を 指定 する こと に より 、 ベ クタ ー 
括弧 演算 子 


の 要素 に アク セス で きま す 。 
m Vector ク ラス の 主 な プロ バテ ィ 


要素 数 が 固定 的 な true の 場合 、Vector オ ブ ジ ェクト の 要素 数 を 変更 で きま せん 。 
ベク ター を 作る つま り 、push()、pop() な どの メソ ッ ド が 発行 で き な く な り ま す 。 


ベク ター 内 の 要素 | 1ength: ベク ター の 要素 数 を 示す 整数 値 で す 。 要 素 が な い ベ クタ ー の 場 

数 を 得る u1n キ 合 、0 に な り ま す 。 

sm Vector ク ラス の 主 な メソ ッ ド 

フィ ルター を か ける F1]ter Boolean 値 を 返す 関数 を 作成 し て 、 そ の 関数 が true を 返す 
値 を 要素 と し て 持つ 新しい ベク ター を 返し ます 。 


各 要 素 に 対し て 関数 を 実行 関数 を 作成 し て ベク ター の 名 要素 に 対し て 実行 で きま す 。 







Vtr[O]= 値 : 
trace(Vtr[O]): 





























する 
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4- 2 
ター 


重 Vector ク ラス の 主 な メソ ッ ド (続き ) 


最後 の 要素 を 取り 出し て ベク ター の 最後 の 要素 を 削除 し ます 。 メ ソ ッ ド の 戻り 値 で 

削除 する その 要素 が 返さ れ ま す 。 ベ クタ ー の 要素 数 (length) は 減少 
し ます 。 

最後 に 要素 を 追加 する push 要素 を ベク ター の 未 尾 に 追加 し ます 。 ベ クタ ー の 要素 数 
(length) は 増加 し ます 。 

要素 の 並び を 反転 させ る 先頭 か ら 未 尾 の 並び 順 を 反転 させ ます 。 

先頭 の 要素 を 取り 出し て | shift ベク ター の 先頭 の 要素 を 削除 し ます 。 メ ソ ッ ド の 戻り 値 で 

削除 する その 要素 が 返さ れ ま す 。 ベ クタ ー の 要素 数 (length) は 減少 
し ます 。 

ソー ト す る gort 比較 を 行う 関数 を 作成 し 、 そ の 結果 に 基づく ソー ト を 実施 
し ます 。 

要素 を 追加 / 削 除 す る sp1ice | 先頭 の イン デック ス と 要素 数 を 指定 し て ベク ター の 要素 を 
追加 / 削 除 で きま す 。 

先頭 に 要素 を 追加 する unshiEc | 要素 を ベク ター の 先頭 に 追加 し ます 。 ベ クタ ー の 要素 数 
(length) は 増加 し ます 。 


要素 を すべ て 文字 列 に する | EoString | ベク ター 内 の 要素 を 「.」 で 区 切ら れ た 文字 列 で 返し ます 。 


































AMPLE C ロ DE 還 EEEEEEEEEEEE 


量 本 的 な ベク ター の 処理 VectorSampleA_fla 


Yar Y :Veotor . <String> = Veotor . <Strinq> ( [ "要素 0" , "要素 1", "要素 2『] ) :// 
オブ ジェ クト の 作成 

traCe( 上 ): // 要素 0, 要素 1, 要素 2 
trace( YEt.1ength ) : // 3 

/ / 未 尾 に 要素 を 追加 

vt .push( "要素 3" ): 

trace( v ): // 要素 0, 要素 1, 要素 2, 要素 3 
trace( vt 上 .1ength ): // 4 

/ / 先 頭 の 要素 を 削除 

Yar 8:Str1nqd = vV 上.ghift () 

traoe( YE ): // 要素 1, 要素 2, 要素 3 
trace( vt.1ength ): // 3 

/ / 並 び 順 を 逆転 

Vt . reverge ( ) : 

traoe( YE ): // 要素 3, 要素 2, 要素 1 


lengoth プ ロ パ ティ と 基本 的 な メソ ッ ド を 使用 し て いま す 。 trace() 関 数 に 配列 オブ ジェ クト 
を 渡す こと で 、toString() メ ソ ッ ド が 呼び 出さ れ て すべ て の 要素 を 出力 で きま す 。 


ベク ター の 要素 を フィ ルター する 





ベク ター 内 の 各 要 素 に 対し て 関数 を 実行 し 、 秒 件 に 合う 要素 の み を 抽出 し て 新しい ベク ター 
を 作成 で きま す 。 こ の よう な フィ ルター 処理 を 行う た め に 、Vector ク ラス の filter0 メ ソ ッ ド が 
用 意 ご され て いま す 。 こ の メソ ッ ド に 設定 する 関数 に は 癌 要素 の 値 が 渡さ れ 、 関 数 が true を 返す 
要素 の み が 新 し い ベ クタ ー と し て filter() メ ソ ッ ド の 戻り 値 に 含ま れ ま す 。 元 の ベク ター は 変化 
し ませ ん 。 


思 Vector ク ラス の フィ ルター メソ ッ ド 詳細 
ソ ッ ド メソ ッ ド の 詳細 


Fi]ten callback : ベク ター 内 の 各 要 素 に 対し て 実行 され る 関数 を 指定 

ca11baok : Function , し ます 。 こ の 関数 が true を 返す 要素 が 新しい ベク ター に 格納 さ 

thisOb]ect:* = nu11 れ て メソ ッ ド の 戻り 値 に な り ま す 。 

: Vector . <〒> thisObject : 関数 内 で this を 使用 し た と き に 参照 され る オブ 
ジェ クト を 指定 で きま す 。 























mW Vector ク ラス の fter() メソッド に 指定 する 関数 の 書式 


Funoctio 1 1back item : ベク ター 内 の 要素 で す 。 こ の 要素 の 値 に 対し て 関数 内 で 演算 
item :, や 判定 を 行い 、true を 返す 要素 が 抽出 され ます 。 


1ndex : 1nt , index : item の 、 ベ クタ ー 内 で の イン デック ス で す 。 
VeCOr : VGCOr . <〒> vector : filter() メ ソ ッ ド を 実行 する Vector オ ブ プ ジ ェ クト で す 。 


T 本 ee 
人 この ] an - 
e 上 ノン = よ よ / 








に =』 韻 コ 蘭 mmm】 コ 議 - - -----------------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ーー 


Vector クラ ス の filter() メソ ッ ド を 使う VectorSampleB.fla 
// ベ クタ ー オ ブ プ ジ ェ クト の 作成 
var 8tudens : VectOr . <Ob]ec> = new Vector . <Ob]ec> () : 


students .pugh( { name: "山田 一 郎 ", score: 88 


) / 
gtudens .Du8h name : "鈴木 二郎 ", score: 78 ) : 
) 
/ 

) 


name : 『 須 腰 俊一 ", score: 25 


げ 


8tudenE8 .DuSh 


/ 


ーー ーー ーー ーー ーー 一 


( 
students .push( { 

( { name: "宮田 三郎 ", score: 44 
students .push( { name : " 三 輸 彰夫 ", score: 63 
//fFi1ter ( ) メソ ッ ド の 実行 と 出力 

Var doOukakKu : Vector . <OD] ect> = gtudentsg .F1i]1ter ( 8CoreF11Eter ): 


for ( var 1:int = 0 : 1 < qoukaku.1enqgth : 1++ ) {1 
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4-2 
2 





Array ク ラス の filter() メ ソ ッ ド の サン プル と ほぼ 同じ 処理 を Vector で 行っ て いま す 。 異 な る 
点 は 要素 の デー タ 型 を すべ て の 個所 で 決め て いる こと で す 。 そ の た め 、 記 述 が や や 複雑 に な る 
印象 を 受け ます 。 





実行 結果 
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ベク ター の 妥 素 を ソー ト す る 





ベク ター 内 の 要素 を ソー ト す る に は 、 関 数 を 作成 し て ソー ト の ロジ ッ ク を 作成 する 必要 が あ 
り ま す 。 こ の よう な ソー ト 処 理 を 行う た め に 、Vector ク ラス の sort() メ ソ ッ ド が 用 意 さ れ て い 
ます 。 こ の メソ ッ ド に 設定 する 関数 は 2 つの ベク ター の ベー ス 型 引数 を 受け て 数 値 を 返す 必要 
が あり ます 。 


sm Vector ク ラス の ソー トメ ソ ッ ド 詳細 
| メソ ッ ド 





メソ ッ ド の 詳細 












compareFunction ソート の ロジ ッ ク を 決定 する 関数 
で す 。2 つ の 引数 を 取り 、 数 値 を 返す 関数 で す 。 


COmDpareGFumC 七 1OT : FumnC ヒ 1 ユ OT , 
) : VeCOr . <> 











和 Vector ク ラス の sort() メソッド に 指定 する 関数 の 書式 
| 関数 関数 の 詳細 


FunC 七 1Om COmpare ( item1 : ベク ター の ベー ス 型 オブ ジェ クト で す 。 





















1tem1 :, item2 : ベク ター の ベー ス 型 オブ ジェ クト で す 。 
1tem2 : T item]1 と item2 を 使用 し て ソー ト 順 を 決定 する ロジ ッ ク を 書き 
) : Number ます 。 


item1 が item2 の 前 に ソー ト さ れる ケー ス の ロジ ッ ク で は 、 マ 
イナ ス の 数 値 を 返し 、 そ の 逆 の ロジ ッ ク で は プラ ス の 数 値 を 返 
す よ うに し ます 。 ど ちら で も な い ( 等 し い ) ケー ス の 場合 、0 を 
返し ます 。 

例え ば ベー ス 型 に score と いう 数 値 フ ィ ー ル ド が あり 、 そ の 昇 
順 で ソー ト し た い 場 合 、 次 の よう な ロジ ッ ク を 書き ます 。 

if ( iteml.score < item2.score ) return 負 の 数 値 : 

if ( iteml.score > item2.score ) return 正 の 数 値 : 

return 0: 








に こち < ん | 関 コ 蘭 mmlp】 ヨ 間 - - - - - -----------------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


Vector クラ ス の filter() メソ ッ ド を 使う VectorSampieC.fla 
/ / ベ バクター オブジェ クト の 作成 


Va 8tudeng : VeCCr . <Ob] ecCt> = new Vector . <Ob] ec> ( ) 


students .push( { name : "山田 一 郎 ", score: 88 } ): 
gtudents .push( 1 name: "鈴木 二郎 ", score: 78 ! ): 
students .push( { name : "須藤 俊一 ", score: 25 } ): 
studentg .push( { name: "宮田 三郎 ", score: 44 } ): 
students .push( { name : " 三 輸 彰 夫 ", score: 63 } ): 


// ソ ー ト と 結果 の 出力 
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PART 
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4-2 
ーー 


8tudenes . Sort 上 ( Compare ): 
For ( var :int = 0 : 1 < students .1ength : 1++ ) { 
traoe ( gtudents[ 1 ] .name + " ぎ 人 上 点数 :" + gtudents[ 1 ] .score ): 
) 
// ソ ー ト ロジ ッ ク を 決定 する 関数 
Function compare ( g1:Ob]ject, sgs2:Ob]ject ) :Number { Ne 





if ( Number( sg1.score ) < Number( gs2.score ) ) return -1: //gs1 の 


score が 小さ い 場 合 、s1 は s2 の 前 に ソー ト さ れ ま す 。 

if ( Number( g1.score ) > Numbper( gs2.gscore ) ) return 1: //gs1 の 
score が 大 きい 場合 、s1 は s2 の 後ろ の ソー ト さ れ ま す 。 

returm 0: / / score が 等 し い 場 合 ソ ー ト は し ませ ん 。 








が ソー ト 関 数 で す 。score の 昇順 で ソー ト し た い 場 合 、 こ の よう な 記述 で 実現 する こと が 
で きま す 。 


ぁ 実行 結果 
須藤 俊一 点数 :25 
宮田 三郎 点数 :44 
三 輸 彰夫 点数 :63 
訂 森 一郎 点数 :78 
山田 一 郎 点数 :88 





PART 
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5 - イ スト リン グ デ ー タ の 処理 
リシン シン ル アン オン 中 に 1 り 友 っ 





合う 


スト リン グ は 一 連 の 文字 か ら な る デー タ で 、「 文 字 列 ] や 「 テ キス ト 」 と も 呼ば れ ま す 。Acti 
onScript プ ログ ラム 中 に “(ダブ ルク オー テー ショ ン ) ま た は (シング ルク オー テー ショ ン ) 
で 囲ま れ た 場所 は スト リン グ デ ー タ と し て 認識 され ます 。 ス トリ ング を 変数 に 格納 し て 処理 す 
る と き は String ク ラス を 使用 し ます 。String ク ラス を 使用 する こと で 、 プ ロバ ティ と メソ ッ ド 
を 使用 し て 下 表 の よう な 処理 を 行う こと が で きま す 。 


ーー て ーー 




















物 String クラ ス の 主 な メソ ッ ド 










ご Cha エム 








スト リン グ 内 の 1 文字 を 取り 
出す 


スト リン グ 内 の 文字 列 を 取り 
出す 


スト リン グ 中 の 指定 し た 位置 の 1 文字 を 取り 出し ます 。 















スト リン グ 中 の 指定 し た 開始 位置 か ら 終 了 位置 まで 
の 文字 列 を 取り 出し ます 。 


スト リン グ 中 の 指定 し た 開始 位置 か ら 指 定 文字 数 の 
文字 列 を 取り 出し ます 。 


人 
の 文字 列 を 取り 出し ます 。 


スト リン グ の 先頭 か ら 指 定 し た 文字 列 を 検索 し ます 。 
last 上 TndexOfF | スト リン グ の 未 尾 か ら 指 定 し た 文字 列 を 検索 し ます 。 
スト リン グ に ある 、 指 定 し た 文字 列 パ ター ン と 一 致 


maECh 
する スト リン グ を すべ て 取り 出し ます 。 


スト リン グ の 先頭 か ら 指 定 し た 文字 列 を 検索 し ます 。 


スト リン グ の 先頭 か ら 指定 し た 文字 列 を 検索 し て 置 
換 し ます 。 











| 

人 
I 

日 

こ ト 
7 

TK 
1 


SuD8 ヒ 了 ュ nd 


1 








1 ndexO 


スト リン グ 内 の 文字 列 を 検索 
する 





ml 








































スト リン グ 内 の 文字 列 を 置き 
換え る 


スト リン グ 内 の 大 文字 を 小 文 | EoLowerCase | スト リン グ に 含ま れる 大 文字 を 小文字 に し ます 。 | 
字 に 変換 する | 
スト リン グ 内 の 小文字 を 大 文 | EoUpperCase | スト リン グ に 含ま れる 大 文字 を 小文字 に し ます 。 





字 に 変換 する 
他 の スト リン グ と 連結 する ConCa 2 つの スト リン グ を 連結 し ます 。 

















9-1-1 
スト リン グ オ ブ ジ ェクト (String) を 使う 


= が 2 上 = 首 四 mp】 ヨ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


String オ ブ ジ ェクト を 生成 し て 文字 数 を カウ ント する StringSampie0.fla 


Var 8:Strind = "スト リン グ の 処理 は String ク ラス の オブ ジェ クト で 行い ます : ーーーーーーー① 
trace( 中" + 8 + "の 文字 数 は " + g.1ength + "あり ます 。" ) : 一 ーーーーーーーーーーー ② 
Var 8DLu8 : St 上 1nd = 8.COnCat( "。『" ) : ーーーーーーーーーーーーーーーーーーーーーーーーーー- ③ 


trace( 中 ! + gp1us + "の 文字 数 は " + sp1us .1ength + "あり ます 。" ): 


で スト リン グ オ ブ ジ ェクト を 作成 し 、② で length プ ロ パ ティ に より 、 文 字数 を 取得 し て い 
ます 。③⑬③ で は concat メ ソ ッ ド に より 文字 列 を 追加 し て いま す 。 


ニア 1 ニー| 敵 コ 











の デ NO 2) 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ーーーーーーー- ーーー 
0 の MA の の て が この KM か AYA が Ne TNI ー - 

こ  * こく こら が で Na だ トン YR こなた oo な. で so CE た) > IT M 時) 

2 寸 - き AKA ここ NO ト つ - P 寺前 し 信昌 


ファ イル (E 表示 恒 人 (CO デバ ッ グ DD 








charCount txt 


= ね | 妥 貞 者 mp】 コ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


TextArea コン ポー ネン ト に 入力 され て いる 文字 数 を カウ ント する StringSampleA.fla 


function getCharCount ( event : Event ) :vo1d 1{ 


CharCOunt xt .texE = nput ta. て text .1engEh . toStringd ( ) : 一 一 ーーーーーーーー ④ 
) 


thig .1nput ta.addEventL1stener ( Event .CHANGE, getCharCount ) : 一 --⑤ 


TextArea に 入力 され て いる テキ スト は text プ ロ パ ティ で 取得 で きま す 。 こ の プロ パテ ィ は 
String オ ブ ジ ェクト な の で 、④ で 行っ て いる よう に 、 そ の まま length プ ロ パ ティ を 参照 で きま 
す 。TextArea コ ン ポ ー ネ ン ト (input_ta) に 入力 が ある と 、Event.CHANGE イ ベン ト が 発生 
する の で 、⑤ で イベ ント リス ナー の 登録 を 行っ て いま す 。 





8/ 


2 スト リン グ か ら 一 部 の 文字 列 を 
取り 出す 





PART スト リン グ オ ブ ジ ェクト 内 の 一 部 の 文字 列 を 取り 出す 場合 、 取 り 出 す 文字 列 の 開始 位置 と 終 
了 位 置 を 指定 し ます 。 各 メソ ッ ド は String オ ブ ジ ェクト か ら 取 り 出 し た 文字 列 を 返し ます が 、 
オブ ジェ クト 内 の テキ スト は 変更 され ませ ん 。 


軌 String ク ラス の 文字 列 を 取り 出す た め の メ ソ ッ ド 詳細 














| メソ ッ ド | メソ ッ ド の 戻り 値 
rharAt Index で 指定 し た 位置 の 1 文字 を 返し ます 。 
index :Number = 0O 先頭 文字 の 位置 は 0 で す 。 





1 1Ce startlndex の 位置 か ら endIndex の 前 まで の 文字 列 を 
S 葉 ar エキ TnQdex : NumDer = 0, | 返し ます 。 
endTndaex : NumDer = Ox7fFFfF 人 仕合 














subgt ュ startIndex の 位置 か ら len で 指定 し た 文字 数 を 含む 文 | 
gt 上 ar 上 Tndex :Numper = 0, 字 列 を 返し ます 。 | 


] en : NumDer = Ox7 人 人 仁 仁 仁 全 





substrinq (tar 上 Tndex :Number = 0, | startIndex の 位置 か ら endIndex の 前 まで の 文字 列 を 
endTndaex : Numper = Ox7fFFfFfF 人 ff 人 人 返し ます 。 


















ーー ーーーーーーーーーーーーーーー 


String オ ブ ジ ェクト か ら 部 分 文字 列 を 取り 出す メソ ッ ド を 実行 する 


var 8:String = "文字 列 の 検索 処理 は StLring ク ラス に 用 意 ご され た メソ ッ ド で 行い いま す 。『": 


EraCe( 8 ): 

も Yace( 『charAt( 9 ) = 『+ gg.charAt( 9) ): 

も YAC@( 『gltoe( 4 8 ) =『+ 8.8IiGe( 4, 8 ) ): 

まあ で 伯 ( BIDBEY( 9, 5 ) = 『 + B.BUD8EY( 9,/ 6 ) }): 
trace ( "substring( 4, 8 ) = " + 8.8ubgtrinqd( 4, 8 ) )』 


trace ( "パラ メー タ の 省略 例 " ): 
つこ リー 1 トッ 0 且 38a 2 0 かり 8 oo 
革 YaCe( 『gubgtr( 9 ) = 『" + 8.8uD8tr( 9 ) ): 


trace ( "gubstrindg( 4 ) = " + 8.8ubstrinqd( 4 ) ): 


① 以 降 は 第 2 パラ メー タ を 省略 し て いま す 。 そ の 場合 、「 ス トリ ング の 未 尾 ま で 」 と いう 指定 
と 同様 に な り ま す 。 
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スト リン グ 中 の 文字 列 を 検索 する 





スト リン グ オ ブ ジ ェクト 内 の 検索 を 行う 場合 、 見 つか っ た 対象 の 位置 を 調べ る 方 法 ( index 
Of lastIndexOf, search) と 、 バ ター ン に 一 致し た 文字 列 の リス ト を 配列 で 取得 する 方 法 (mat 
ch) が あり ます 。 見 つか っ た 位置 は 、 先 頭 文字 の 位置 を 0 と する int 値 で 返 ご れ ま す 。match() 
メソ ッ ド は 見 つか っ た 要素 を 配列 で 返し ます 。 


mm String クラ ス の 文字 列 を 検索 する た め の メ ソ ッ ド 詳細 


| メソ ッ ド メソ ゾ ッ ド の 戻り 値 

















FRP 還 3 
indexOf (va1 : Str1ng, StartTndex: | startlndex 以 降 で val で 指 定 し た 文字 列 を 検索 し て 見 ま 
Number = 0) :int | つか っ た 位置 。 先頭 文字 の 位置 は 0 です 。 見 つか ら な 
い 場 合 は -1。 
lastTndexOf (va1 : Strind , スト リン グ を 末尾 か ら 検 索 し ます 。startlIndex 以 前 で 
gtartTndex : Number = Ox7EFFFFfFF) : | val で 指定 し た 文字 列 を 検索 し て 最初 に 見 つか っ た 位 





1T]1L 四 。 先頭 文字 の 位置 は 0 で す 。 見 つか ら な い 場 合 は -]。 














jpatern : * ) :A エ エ ay pattern で 指定 し た 文字 列 と 一 致す る スト リン グ を す 
べ て 格納 し た 配列 。pattern は 正規 表現 も 使用 で きま 
す 。 一致 が な か っ た 場合 、null。 











searoh (pattern :*) :int pattern で 指定 し た 文字 列 と 一 致し た 部 分 の 先頭 位置 。 
pattern は 正規 表現 も 使用 で きま す 。 一致 が な か っ た 
場合 、 - | 。 











上 導 計 mp】 粒 ーー ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


String オブジェ クト 内 の 文字 列 を 検索 する StringSampleC.fla 
Var 8:Strinq = " 各 メ ソ ッ ド で 共通 する こと は 、 メ ソ ッ ド は Str1ing オ ブ ジ ェクト か ら 取 り 出 し た 文字 列 
を 返す こと で す 。": 
traCe( 8 ): 

も きき CG ( 『 上 ndexOf ( ! メ ソ ッ ツ ド ! ) ゃ 『 + gi、lhndexof( ! メ ン ッ ド ! ) ): 

trace( 『]lastTndadexOf ( ! メ ソ ッ ド ! ) = " + g.1agstTIndexOfF ( ! メ ソ ッ ド ! ) ): 
も Y&C@ ( 『maEoh( '* メ ズ メソッド! ) = " + 8.match( ! メ メソッド! 「) ): 

も Y あ CB ( BB 人 AYGD( メソ ツ ッ ド * う ) ma 『" + g.gearCch( "メソッド ) )) 


それ ぞ れ の メソ ッ ド 呼び 出し で "メソ ッ ド "と いう 文字 列 を 検索 し て 見 つか っ た 位置 、 ま た は 
その 文字 列 目 体 を 返し ます 。 
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スト リン ク グ 中 の 文字 列 を 置換 する 





スト リン グ オ ブ ジ ェクト 内 の 置換 は replace メ ソ ッ ド で 行い ます 。 置換 する 文字 列 の 検索 方 
法 は 、 完 全 一 致 に よる 指定 と 正規 表現 に よる バタ ー ン マッ チン グ が 行え ます 。 見 つか っ た 文字 
を 置換 する と き に 利用 で きる "$" に よる オプ ショ ン 書式 が あり ます 。 


昔 String ツ ラス の 文字 列 を 取り 出す た め の メ ソ ッ ド 詳細 

















メソ ッ ド トー | メ ソ ッ ド の 戻り 値 “ 
Fep] ace (Dat て erm : * , pattern で 指 定 し た 文字 列 と 一 致す る 最初 の 文字 列 を repl で 指 定 さ | 
aa Ob]ject ) : Stringq れる 文字 列 に 置き 換え た 後 の ス トリ ング 全体 。repl に は 関数 も 指定 

で きる た め 、Object 葉 に な っ て いま す 。 1 














生 $ コー -ー ド に よる オプ ショ ン 書 式 






























































N) 見 つか っ た 文字 を ET9」 に 置 き 換 える と き に 使用 し ます 。 

[ | | 

$①@x 見 つか っ た 文字 列 を 表し ます 。 

ト 

$ 兄 つ か っ た 文字 列 よ り 前 の 部 分 文字 列 を 表し ます 。 

守 ーー こ 

ゃ ① 見 つか っ た 文字 列 よ り 後ろ の 部 分 文字 列 を 表 し ます 。 

$ n バタ ダ ターン で ( ) に よる グル ー プ 指 定 を し て いる と き 、 致し た 文字 列 を グル ー プ の イン デ ッ 

クス に より 取得 で きま す 。 先頭 グル ー プ の イン デック ス は 1 で す 。 9 まで 指 定 で きま す 。 

1 + ad 

| ⑪ nn パタ ー ン で ( ) に よる グル ー プ 指 定 を し て いる と き 、 ー 致 し た 文字 列 を グル ー プ の イン デ ッ 
| フス に より 取得 で きま す 。 先頭 グル ー プ の イン デック ス は 01] で す 。99 ま で 指定 で きま す 。 








に 2 画 コ 首 mp】 ヨ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


完全 一 致 で 最初 に 見 つか つた 文字 列 を 置換 する StringSampleD1.fla 


Var 8:Str1nq = 『 難 Method で Method は 文字 列 を 返し ます 。" : 
trace( 8.replace( 'Method' , ! メ ソ ッ ド ! ) ) :// 間 メ ソ ッ ド で Method は 文字 列 を 返し ます 。 


スト リン グ に は Method と いう 文字 列 が 2 つ あ り ま す が 、 完 全 一 致 で は 最初 の 対象 の み が 置 
換 さ れ ま す 。 


ァ 実行 結果 
和音 メソ ッ ド で Method は 文字 列 を 返し ます 。 


5- 1 -4 
スト リン グ 中 の 文字 列 を 置換 する 


= た 和 2 前 = 才 mmlp】 コ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


完全 一 致 で 見 つか つた すべ て の 文字 列 を 一 括 置換 する StringSampieh2.fla 
Var 8:Str1ng = 『 各 Method で Method は 文字 列 を 返し ます 。" : 
traCe( 8.replace( /Method/9, "メソ ッ ド ! ) ):  // 和 名 メ ソ ッ ド で メソ ッ ド は 文字 列 を 返 
し ます 。-ーーーーーーーーーーーーーーーーー 一 一 一 





①⑬ 


完全 一 致 で 見 つか っ た すべ て の 対象 を 一 括 置換 する に は 、① で 指定 し て いる よう に 、/ 検 索 文 
字 列 /9 と いう 正規 表現 の 指定 を 行い ます 。g は global の 意味 で 、 す べ て を 検索 し ます 。 


実行 結果 
各 メ ソ ッ ド で メソ ッ ド は 文字 列 を 返し ます 。 


= た 妥 前 = 考 四 mp】 ヨ 間 | ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


$ ふ コード の 内 容 を 確認 する StringSampleD3.fla 


Var 8:Str1nd = "012 Method 345": 

trace( 8 ): 

// "Method" を "$! に 置き 換え ます 。 

も あの 夫人 の 間 ま CR ( - / 捕 EMIOG/ 。 する きき SW) ) 】 ニニ ー モ ーー ルー ニーー ニ ドー ニー 
// "Method "を "Method shou1d be Rep1aced" に 置き 換え ます 。 

trace( 8.replace( /Method/, "Sg shou1d be Rep1aced" ) ) : 一 ーーーーーーー- ③ 
// "Method "を "Method" の 前 に ある 文字 列 に 置き 換え ます 。 

trace( 8.replace( /Method/, "$~" ) ) , 一 一 一 ーーーーーーーーーーーーーーーーーーーーーー- ④ 
/ / "Method "を "Method" の 後ろ に ある 文字 列 に 置き 換え ます 。 











trace( 8.replace( /Method/, "S!" ) ): ⑤ 
//"012_Method" を 012 と "M" に グル ー プ 化し て 検索 し 、 そ れ ぞ れ [] で 囲い ます 。 
EraCe( 8.replace( /([0-9]+) ([A-Z] ) /g, " [$11 [$2]" ) ) ,- 一 一 一 ーーーーーー⑥ 


92 の "$$" に よる 指定 で は 、 マ ッ チ し た "Method "が "$" に 置換 され て いま す 。 

3 の "$&" は 、 マ ッ チ し た "Method "を 表し ます 。 

④ の "$ "は 、 マ ッ チ し た "Method "の 前 に ある 文字 列 を 表し ます 。 

5 の "$" は 、 マ ッ チ し た "Method "の 後ろ に ある 文字 列 を 表し ます 。 

⑤ で は 、"$1" が 1 番目 の ([0-9]+) グ ルー プ に マッ チ し た 文字 列 、"$2 "が 2 番目 の ([A-Z]) グ ル 
ー プ に マッ チ し た 文字 列 を 表し ます 。 
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PART toLowerCase、toUpperCase メ ソ ッ ド に より 、String オ ブ ジ ェクト 内 の 文字 列 中 に ある ア 
ルフ ァ ベ ッ ト の 大 文字 / 小 文字 の 変換 が で きま す 。String オ ブ ジ ェクト 内 の 文字 変換 を 行い 、 結 
果 を 返し ます が 、 元 の オブ ジェ クト 内 の テキ スト は 変更 され ませ ん 。 


WW String ク ラス の 文字 列 を 取り 出す た め の メ ソ ッ ド 詳細 
メソ ッ ド | メソ ッ ド の 戻り 値 





















































1 ( S 上 rind スト リ ング に 含ま れる 変換 可能 な 大 文字 を 小文字 に し て 返し ます 。 

| COUDDG エ に 8 : St 上 1n9 スト リン グ に 含ま れる 変換 可能 な 小文字 を 大 文字 に し て 返し ます 。 
2 者 間 還 科 才 凍 上 人 引 琴 較 - - ------------ーー ニ ーー ニー ニー ニー ニニ ーー ニー ニニ ーー ニー ニー ニー ニー ニー ニニ ーー ニニ ニー ニー ニー ニー ニニ ニー ニー ニニ ニニ ーー ニニ ーーー 

String オブ ジェ クト 内 の 大 文字 <=> 小文字 変換 を 行 つ StringSampleE.a 
yar sg:Strinq = "EoLiowerCase メ ソ ッ ド は 大 文字 > 小文字 の 変換 を し ます 。" : 
trace( 8 ): 
trace( "gs.toTiowerCase() = " + g.toLocaleLiowerCase() ): 
trace ( "ag.toUpperCase() = " + g.EoLocaleUpperCase() ): 


toLowerCase メ ソ ッ ド と toUpperCase メ ソ ッ ド は 主 に アル ファ ベッ ト の 大 文字 / 小 文字 変換 
を 行い ます 。 ス トリ ング 中 の 変換 可能 な 文字 の み が 対 象 と な り ま す 。 


ぁ 実行 結果 
toLiowerCase メ ソ ッ ド は 大 文字 > 小文字 の 変換 を し ます 。 
s .toliowerCase ( ) = to1owercase メ ソ ッ ド は 大 文字 > 小文字 の 変換 を し ます 。 
8 .toUpperCase ( ) = TOLOWERCASE メ ソ ッ ド は 大 文字 > 小文字 の 変換 を し ます 。 


9Z 








flash.utils パ ッ ケ ー ジ に 含ま れる escapeMuhiByte 関 数 で スト リン グ を URL エン コー ド 、 同 
じ く unescapeMultiByte 関 数 で URL デコ ー ド を 行え ます 。URL エ ンコ ー ド 処理 は エス ケー ブ 、 
デコ ー ド 処理 は アン エス ケー プ と も 呼ば れ ま す 。 


還 flash.util パ バッ ケー ジ の URL エン コー ド / デ コー ド 関 数 



































メソ ッ ド メソ ゾ ッ ド の 戻り 値 
escapeMu1tiByte (value : String) : St 上 rind value を URL エン コー ド し た 値 を 返し ます 。 
unesCapeMu] 七 1Byte (Value : S 上 1n す ) : S 上 エ ュ nd valle を URL デコ ー ド し た 値 を 返し ます 。 














AMPLE ビ ロ ロ E 語 EE 


URL エン コー ド / デ コー ド を 行う StrindSampleFfla 
1mport Fl]ash .ut 上 1]s .eSsCapeMu] 上 1Bye: 
1mport Flash .ut11gs .umneSCapeMult1Bye : 
trace( esoapeMu1tiByte ( "Flash で エス ケー プ 『 ) ): 
trace( unescapeMu1tiByte( "F]ash る EE3 る も 81 も A7 も EE3 を 82 る A8 る 忌 3 る 82 る B9 る EE うる 82 る B1 る 
E3 る 83$BC も E3$83 も 97" ) ): 


エン コー ド す る 文字 列 に 半角 英 数 字 (ASCII 文 字 ) が 含ま れる 場合 、 それら は エス ケー プ さ れず 
その まま 残り ます 。 


> 実行 結果 
F]1aghE3 も 81A7E3%82%A8E う 82 を B9 も E3 和 82B1E3 和 を 83 名 BC を E3 も 8397 
E1ash で エス ケー プ 
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5 - 2 正規 表現 
正規 表現 で 行え る こと を 把握 する 





PART 
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日 付 が 書式 に 合っ て いる か チェ ッ ク す る | nnnn 年 nn 月 nn 日 の 形式 に 合致 する か 調べ る 。 








正規 表現 は 文字 列 の バタ ー ン を 表現 する 記法 で す 。ActionScript は 正規 表現 を サポ ー ト する 
た め 、 ア プリ ケー ショ ン で ユー ザ カ が 入力 し た 文字 列 が 電子 メー ル ア ドレ ス 、 郵 便 番 号 や 電話 番 
号 な どの 書式 と 一 致す る か を 調べ た り 、 ス トリ ング 内 で 、 あ る 文字 列 の パタ ー ン を 検索 、 置 換 
する こと が で きる よう に な り ま す 。ActionScript3.0 で は 、ECMAScript Edition 3 言語 仕様 
(ECMA-262) の 定義 に 基づく 正規 表現 を 実装 し て お り 、 正 規 表 現 の リテラ ル も サポ ー ト され て 
いま す 。 正 規 表現 は 下 表 の よう な 利用 方 法 が あり ます 。 


W 正規 表現 の 使用 例 






































目的 の 
族 字 を 検索 する 。 10.123.2000 な どの 任意 の 数 字 を 検索 する 。 | 
指定 本 数 の 数 字 を 検索 する | 11.22 な どの 2 桁 の 数 値 を 検索 する 。 ーー 
指定 桁 数 の 数 字 の 組み 合わ せ を 検索 する | 2 桁 の 数 字 ま た は 3 桁 の 数 字 を 検索 する 。 ーー 














2 杵 の 数 字 + 1 文字 (b)+3 桁 の 数 字 の 組み 合わ せ を 検索 する 。 


























日 付 を 検索 する ] 

正しい 郵便 番号 か チェ ッ ク す る nnn-nnnn 形 式 の 郵便 番号 形式 に 合致 する か 調べ る 。 
郵便 番号 を 検索 する 

正しい 電話 番号 か チェ ッ ク す る 2-4 桁 + 3-4 桁 + 4 桁 形式 の 電話 番号 に 合致 する か 調べ る 。 
電話 番号 を 検索 する 





止 し い メ ー ル アド レス か チェ ッ ク す る 標準 的 な メー ル ア ド レス で ある か 調べ る 。 
メー ル ア ド レス を 検索 する 























止 し い URL か チェ ッ ク す る 止 し い URL で ある か 調べ る 。 

















URL を 検索 する 
全角 文字 の み を 検索 する Shift-JIS テ キス ト 内 の 全角 文字 を 抜き 出す 。 











指定 し た パタ ー ン の 文字 列 を 検索 する 山田 + 1 文字 か ら な る 名 前 を 検索 する 。 
全文 検索 を 行う 














基本 的 な 正規 表現 を 行う 





正規 表現 に よる 処理 を 行う に は 、RegExp ク ラス の イン スタ ンス を 作成 し ます 。String ク ラ 
ス の match(0)、replace()、search() で も 正規 表現 イン スタ ンス を 使用 し て バタ ー ン マッ チン グ 
行う こと が で きま す 。 RegExp ク ラス の コン スト ラク タ に より 、 指定 の 正規 表現 を 持つ オブ ジェ 
クト を 生成 で きま す 。 ま た 、ActionScript は 正規 表現 リテラ ル を サポ ー ト する の で 、 コ ンス ト 
ラク タ を 使用 し な く て も プリ ミ テ ィ ブ デー タ 型 と 同じ よう に イン スタ ンス を 生成 で きま す 。 イ 
ンス タン ス を 生成 し た ら 、RegExp ク ラス や String ク ラス の メソ ッ ド で 正規 表現 に よる バター 
ンマ ッ チ ング を 行う こと が で きま す 。 


RMOPAD グ フク の コン ヘマ ンマ 














| メソ ッ ド メソ ッ ド の 働き ' 
ReqExp ( re : String, fF1ags : String) | コン スト ラク タ で は 、 パ ラメ ー タ で 正規 表現 の 本 体 で あ 
6G :・ 正規 表現 の パタ ー ン る パタ ー ン と 、 オ プシ ョ ン の フラ グ を 指定 し て イン スタ 
F]1ags : 正規 表現 で 使用 され る フラ グ ンス を 生成 で きま す 。 

















らら AMPLE ロロ ロ E EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


RegExp クラ ス の イン スタ ンス を 生成 する 


/ / コ ンス トラ クタ に よる イン スタ ンス 生成 
var myReqExp : ReqdExp = new ReqExp( "山田 ", "gd" )j: 


/ / リ テラ ル に よる イン スタ ンス 生成 
var myReqgExp :ReqgExp = / 山 田 /d: 


和 RegExp ク ラス の メソ ッ ド 
| メッ ッ ド | メソ ッ ド の 働き と 戻り 値 


exeC【( 8 上 : 9 上 エ 1nd :Obect 正規 表現 に よる 検 索 を 行い 、 一 致 が な い 場 合 null、 一致 が 
gtr : 正規 表現 を 検索 する スト リン グ | あっ た 場合 、 一 致し た 文字 列 と イン デック ス を プロ パテ ィ と 
し て 持つ オプ ジェ クト を 返し ます 。 

この メソ ッ ド は 複数 の マッ チン グ 結 果 を 調べ る 場合 な ど に 使 
用 で きま す 。 


5 七 ( Sr : S 上 エ ュ nd) : BOO] 正規 表現 に よる 検索 を 行い 、 一 致 が な い 場 合 false、 一 致 が 
5 5 a 正規 表現 を 検索 する スト リン グ あっ た 場合 、true を 返し ます 。 

この メソ ッ ド は メー ル ア ド レス の フォ ー マ ッ ト が 正しい か を 

チェ ッ ク す る 場合 な ど に 使用 で きま す 。 
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5-Z 
正規 表現 





符 RegExp に 


awttndeoes gn ソ ッ ッ ド と test() メ ソ ッ ド に かる チェ ッ ク を 開始 する 位置 で す 。 遇 ey 
Number と に より 、 ス トリ ング 内 の どの 部 分 か ら 検 索 を 開始 する か を 決め る こと が で きま す 。 





ー ニ アン |] 韻 コ 蘭 mimlp】 コ 
完全 一 致 に よる 大 本 的 な 正規 表現 検索 








①、⑧ で RegExp オ ブ ジ ェクト を 作成 し て いま す が 、 フ ラグ を 含ま な い 基 本 的 な も の で す 。 
この よう に / / で 囲ん だ 内 側 に 文字 列 を 指定 する こと で 、 そ の 文字 列 と の 完全 に 一 致す る 部 分 を 
スト リン グ か ら 検 索 で きま す 。 

① の 正規 表現 で は 、「 島 田 ] と いう 文字 列 に マッ チ す る 個所 を 検索 し ます 。(③⑬③ の 結果 は true に 
な り ま す 。 

⑧② で 作成 し た オブ ジェ クト は 「 吉 田 」 を 検索 し ます が 、str に 含ま れ な いた め 、④ の test() メ 
ソ ッ ド は false を 返し ます 。 





ぁ 実行 結果 





の エス: よさ まっ 千 と を タ か ・ だ た ゴー アル レル 





正規 表現 で は 、 例 えば 「" 田 "で 終わ る 2 文字 の 文字 列 ] と いう よう な バタ ー ン 検索 を 行う こと 
が で きま す 。 こ の パタ ー ン に は 例え ば 「 山 田 、 島 田 、 吉 田 ] な だ ど が マッ チン グ し ます 。 正規 表現 
で 任意 の 1 文字 を 表す に は 、「. 」 (ドッ ト ) を 使用 する た め 、 上 記 の 正規 表現 は | /. 田 / 」 に な り ま 
す 。「.」 (ドッ ト ) の よう に 文字 単位 の 表現 を 行う も の を 「 メ タ 文 字 ] と 呼び ます 。 








パタ ー ン 一 致 例 






































正規 表現 例 
. (ドット ) 任意 の 1 文字 に 一 致し ます 。 改行 文字 | /.AB./g A1AB2 
(\n) に は s フ ラグ を 設定 し た 場合 の み 一 AAABBB 
致し ます 。 | ezAB@Z 
ーー ー ーー 時 ーー] 
^ (キャ レッ ト ) スト リン グ の 先頭 に 一 致し ます 。m フ ラ | /^AZ/g | AZ1234 
グ を 設定 し た 場合 は 、 行 の 先頭 に も 一 致 AZAZazAZ 
し じ ま ず す 。 
[ ーー ニー ー ー ーー ーー ニー 
$ (ドル 記号 ) スト リン グ の 未 尾 に 一 致し ます 。m フ ラ | /AZ $/g AZ1234AZ 
グ を 設定 し た 場合 は 、 改 行文 字 (\n) の azAZ 
| 直前 の 位置 に も 一 致し ます 。 
* (アス タリ スク ) | 直前 の アイ テム に つい て 0 回 以上 の 繰り | /1*a/g 1a12a12311a 





返し に 一 致し ます 。 














































































































+ (プラ ス ) | 店 の アイ テム に つい て 1 回 以上 の 繰り | /1+a/g | 1a12a12311a 
返し に 一 致し ます 。 | 
? (疑問 符 ) 直前 の アイ テム に つい て 1 回 また は 1 回 | /17a/9 1a12a12311a 
だ け 一 致し ます 。 
SS ザ ) | の 右側 また は 左側 の パタ ー ン に 一 致し | /1.I12 /g la12a12311a 
ます 。 
_ | - 
| \ (円 記号 ) 特殊 文字 が 持つ 特別 な 意味 を 無効 化し ま | /a \//9 1a/1b/13a/ 
す 。 
( ) 正規 表現 の 中 で グル ー プ を 定義 し ます 。| /(112)a/g la12a1231 1a 
ゲ グループ は 複数 の パタ ー ン の 組み 合わ せ 
で 繰り 返し を 指定 する と き に 使用 し ます 。 
ーー ー 十 ーー 
| 」 | 昌 内 に 指定 し た いずれ か の ] 文字 に 一 致 | (\d\D)* | 1a 12b123c 4d | 
し ます 。- (ハイ フン ) を 使用 し て 文字 の 
節 囲 を 次 の よう に 指定 で きま す 。 /[12]a/g |a1DZaZz3x3y4w4z 
[121】 "1 か 2 の いずれ か に 一 致 4 | ]。1b2a2z3x3v4w4z 
[1-9]】 1 て 9 の いずれ か に 一 致 | 
[1-9a-z] 1 て 9 また は az の いずれ か に | /[1-2w-y]/g | 1a1b2a2z3x3y4w4z 
一 致 
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9-Z 
正規 表現 


ブル ー プ の 使用 
複数 の パタ ー ン 文字 を グル ー プ と し て 繰り 返し の 指定 な ど を 行う こと が で きま す 。 例 えば 
(\d\D)* は 数 字 (\d) と 数 字 以 外 (\D) の 文字 の 組み 合わ せ が 0 回 以上 繰り 返す こと を 指示 し ます 。 


和 土 ActionScript3.0 正規 表現 の グル ー プ 


フラ グ ブ の 使用 

正規 表現 バタ ー ン の み の 指 定 で は 、 実 際 に は 最初 に 見 つか っ た 一 致 箇所 で 検索 は 終了 し ます 。 
上 記 の メタ 文字 表 の 一 致 例 で は 、 複 数 の 一 致 個 所 を 示し て いま す が 、 こ れ は 正規 表現 に / g と 
いう フラ グ を つけ て いる た めで す 。g は global を 表し 、 複 数 個所 の 一 致 を 行う 指示 と な り ま す 。 
フラ グ は 正規 表現 バタ ー ン の 未 尾 の / の 後ろ に 指定 し ます 。 













/ 表現 パタ ー ン / フラ グ 


特 ActionScript3.0 正規 表現 の フラ グ 
複数 の 一 致 を 行い ます 。 


I(ignoreCase) | 大 文字 と 小文字 を 区 別 し な いで 一 致 を 


行い ます (デフォ ルト で は 大 文字 と 小 文 



















/.2/g A1B2C3a1b2c3 


/c3/ig A1B2C3a1b2c3 













字 は 区 別 さ れ ま す )。 






複数 行 の スト リン グ で 、^( キ ャ レッ ト ) を A1B2C3 
各行 頭 、$ (ドル 記号 ) を 各行 末 に 一 致 させ a1b2c3 














ます 。 デフ ォ ル ト で は 、 ^ は スト リン グ の 先 
頭 、$ は スト リン グ の 未 尾 に の み 一 致し ます 。 


Another Line 






















s(dotall) .( ド ッ ト ) を 改行 文字 (\n) に も 一 致 さ せ | /3./sg A1B2C3 
ます 。 デフ ォ ル ト で は 一 致し ませ ん 。 1Db2c3 
Another Line 






正規 表現 パタ ー ン 内 の 空白 文字 を 無視 
し ます 。 パ ター ン を 読み や すく する た 
め に 使用 し ます 。 










A1B2ZC3 
1Db2c3 
Another Line 


/^a./xmig 















X(extended) 


= が 2 上 避 肖 = 疾 還 mp】 コ 蘭 --- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


メタ 文字 を 使用 する 正規 表現 検索 RegExpSampleB.fla 


※/^a./mig と 同じ で す 。 


9-Z-3 





文字 を 検索 する (メタ 文字 と フラ グ ) 
var 801 :Str1inq = 『1a12a12311a": 
// ・ 
redexDp = /1./q: trace( gs01.match( regexp ) ): 
二 内 1 
regexp = /"1a/g: trace( s01 .match( regexp ) ): 
// $ 
redexp = /1a$/q: trace( s01.match( regexp ) ): 
な 絆 le 
regexD = /1*a/: trace( 801.match( regexp ) ): 
の 
redexD = /1+a/q: trace( s01.match( reqgexD ) ): 
「/ 
redexD = /1?a/q: trace( s01.match( reqexp ) ): 
// | 
redexDp = /1.|12/gq: trace( s01.matoh( regexp ) ): 
人 
redexp = /(1|2)a/g: trace( s01 .match( regexp ) ): 
お 


redexp = /[12]a/q: trace( s01.match( reqgexp ) ): 
801 = "1a/1b/13a/『: 

// \ (円 記号 ) 

redexD = /a\//q: trace( 801.match( reqgexDp ) ): 


g フ ラグ の 結果 を 確認 する た め に 、String ク ラス の match0 メ ソ ッ ド を 使用 し て いま す 。 こ 
の メソ ッ ド は 一 致し た 結果 を 配列 に 格納 し て 返す た め 、trace() に より 、 一 致し た 文字 列 が 出力 
され ます 。 


ぁ 実行 結果 
まん まあ よ よ 
1a 
14 
1a,a, 114 
1a,11a 
1a,a, 18a 
覆 ま ょ よる よ よ 
1a,2a,18 
1a, 2a, 1a 
a/ , a/ 
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9ー- メ 
止 規 表現 


= ある 1 コ 画 コ 首 中 mp】 コ 蘭 --- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


フラ グ を 使用 する 正規 表現 検索 RegExpSampleC.fla 


メア / フ ラグ 

Ya 8 七 了 :S 上 1nd = "A1B2C3a1b2cC3『 : 

3 2 失 ・ (g1oba1 ) 

redexDp =/.2/q: traoe ( str.match ( reqgexDp ) ): 

志 め 人 ( iqgnoreCa8e ) 

redexD =/c3/1q: race( str.matoh( regexp ) ): 
8 キ 上 エ = "A1B2C3\ ぎ ma1b2C3 ぎ mAnother Line": 

// m (mu1ti1] ine ) 

redexDp =/“a./miqg: raoce( str.match ( reqexp ) ): 


// g (dota11 ) 
redexD =/3./8sq: traoe( str.matoch( reqexp ) ): 
た 甘 (extended ) 


redexDp =/ “ a . /xmig: trace( str.match( regexp ) ): 


各 フ ラグ の 結果 を 確認 する た め に 、String ク ラス の match() メ ソ ッ ド を 使用 し て いま す 。 こ 


の メソ ッ ド は 一 致し た 結果 を 配列 に 格納 し て 返す た め 、trace() に より 、 一 致し た 文字 列 が 出力 
され ます 。 


> 実行 結果 


B2 , b2 

US 衣 才 e 

A ム 1 ,a1 , An 
9 

A ム 1 ,a1 , An 


作っ た ユ ス : ェ はら を - ん クニ ショ アシ 3 





スト リン グ 中 の 数 字 は 文字 の 一 部 で す が 、 正 規 表 現 で は 数 字 と 一 致す る 数 字 パ ター ン が 使用 
で き 、 よ く 使 用 され ます 。 数 字 の バタ ー ン は 電話 番号 や 郵便 番号 、 ク レジ ッ ト カ ー ド を は じ め 
と し て 多く の 検証 や 検索 に 必要 に な る た めで す 。 例 えば \d と いう 表現 は 0 一 9 の いずれ か の 数 
字 に 一 致す る バタ ー ン で す 。\d の よう に \ で 始ま る 表現 は メタ シー ケン ス と 呼ば れ ま す 。 


き ActionScript3.0 正規 表 志 の メタ シー ケン ス 
メタ シー ケン ス 




















パタ ー ン 一 致 例 。 | 
ESSN RY 









































































































































\d 0 9 の 数 字 1 文 字 に 一 致し ます 。 la 12b-123c 4d 
\D 数 字 以 外 の 1 文字 に 一 致し ます 。 / \D+/g 1a_12b-123c 4d 
\w a >Z、A…/Z、0 て 9、_ に 一 致し ます 。 こ | / \w+/g la 12b-123c 4d 
れ ら の 文字 は 単語 構成 文字 と 呼ば れ ま す 。 
\W 語 構成 文字 以外 に 一 致し ます 。 / \VV+/g 1]a 12Db-123c 4d 
\bD 語 構成 文字 と 空白 文字 な どの 単語 構成 文字 | / \b \d/g ]a 12b-123c 4d 
以外 の 文字 と の 境界 位置 と 一 致し ます 。 ス ト 
リン グ の 先端 か 未 尾 が 単語 構成 文字 の 場合 、 
それ ら と も 一 致し ます 。 
\B 単語 構成 文字 に 挟ま れ た 位置 、 ま た は 単語 構 | / \B \D+/g | 1s 12b-123c 4q 
成文 字 以 外 の 文字 に 挟ま れ た 位置 と 一 致し ま 
し 記 
\S スペ ー ス 、 タ ブ 、 改 行 、 復 帰 に 一 致し ます 。| / \s \d/g 1a 12b-123c 4d 
これ ら の 文字 は 空白 文字 と 呼ば れ ま す 。 
ーー 1 還 
\S 空白 文字 以外 に 一 致し ます 。 層 昌 \d/g | 1a 12b-123c 4d 
\n 改行 文字 に 一 致し ます 。 スト リン グ 中 の 各 文 字 位置 で 一 致し 
ます び 。 
\r 復帰 文字 に 一 致し ます 。 
\t タブ 文字 に 一 致し ます 。 
「 wv 垂直 フィ ー ド 文字 に 一 致し ます 。 
\xnn 16 進 数 nn で 示さ れる ASCII 文 字 1 文字 に 一 致 | / \x42/ ABCDE あ いう 
| | し ます 。 | 
| \unnnn 16 進 数 nnnn で 示さ れる Unicode 文 字 1 文 字 | / \u3044/ | ABCDE あ いう 
に 一 致し ます 。 | 
綴り 返し 表現 の 使用 


上 記 メ タ シ ー ケ ンス 表 の 例 で /\d+/g の よう に + 記 号 を 使用 し て いま す が 、 こ れ は 「 直 前 の ア 
イ テ ム を 1 回 以上 繰り 返す ] と いう 繰り 返し 表現 で す 。 つ まり 、\qd+ は 「1 つ 以上 の 数 字 」 と 一 
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10Z 


9-Z 
正規 表現 


致し ます 。 正規 表現 で は 、 こ の よう な 繰り 返し 制御 文字 が いく つか 用意 され て いま す 。 


符 ActionScript3.0 正規 表現 の 繰り 返し 制御 文字 


直前 アイ テム の 0 回 また は 1 回 の 繰り 返し に 一 致し ます 。| /17a/g 11a 112a 122ca 






























(mj 繰り 返し 回 数 また は 回 数 の 範囲 を 指定 し ます 。 / \d{2]/g 11a 112a 122ca 
、 の 場合 ヽ 
ーー に / \d{2J/g | 11a 112a 122ca 
{m.n} の 場合 m 回 以上 n 回 以下 







の 繰り 返し に 一 致し ます 。 


/ \d{2.3]/g | 11a 112a 122ca 


= を 1 四半 gm ヨミ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


メタ シー ケン ス を 使用 する 正規 表現 検索 RegExpSampleD.fla 
/ メ あ ダ シー ツジ シス 

s01 = "1a 12b-123c 4d": 

// \Q 数 字 を 検索 

trace( gs01 .match( /\d+/d ) ): 
trace( s01 ユ 1.match( /\D+/ す ) ): 
// \w 単語 構成 文字 を 検索 

traoe( 801 ユ .match( /\w+/d ) ): 
trace( s01 ユ .match( /\W+/q ) ): 
/ / \D 単語 構成 文字 の 境界 

trace( s01.match( /\b\d/g ) ): 
trace( 8g01 ユ 1.match( /\B\D/g ) ): 
// \sg 空白 文字 

traoce ( s01 .match( /\s\d/d ) ): 
trace( 801.match( /\S\d/q ) ): 


> 実行 結果 
上 よう よう, 信 
し 
1a 12b, 123c, 4d 


1 , ユ ,4 

る 。 の な) 
E 

ey 


ら 9ー メ ー ム ん 
数 字 を 検索 する (メタ シー ケン ス ) 


| 肖 = 考 mmp】 コ 六 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


繰り 返し 制御 コー ド を 使用 する 正規 表現 検索 ReqExpSampleE fla 
/ / 繰り 返し 制御 
801 = "11a 112a 122ca": 


// * : 0 回 以上 の 繰り 返し 
trace( gs01.match( /1*a/qd ) ): 
// + : 1 回 以上 の 繰り 返し 
trace( s01.match( /1+a/qd ) ): 
// ? : 0/1 回 の 繰り 返し 
traoe( s01 .match( /1?a/g ) ): 


た 本 

traoe( s01 .match( /\d{21/g ) ): 
2 

traoe( s01 .match( /\d{f2,)/g ) ): 
人 内 R 


trace( gs01.match( /\df{2,31/g ) ): 


実行 結果 
11a,a,a 
1a 
1a,8a,a 
あま 
な の 放 の ザ め テ ゲ 
証人 カンダ 


= 上 肖 = 導 中 m】 コ 敵 ーー 


数 字 十 文字 の パタ ー ン 検索 RegExpSampieFjla 
Var 801 :Str1nd = "1a 12b123o 4qd!": 
/ / 2 桁 の 数 字 を 検索 
trace( gs01.matoh( /\d{2})/ ) ): //12 


/ / 2 桁 の 数 字 ま た は 3 桁 の 数 字 を 検索 

trace( gs01.match( /\d{3j|\d{21/g ) ): //12,123 
/ / 2 桁 の 数 字 +1 文 字 (b) + 3 桁 の 数 字 の 組み 合わ せ を 検索 

trace( s01.matoh( /\d{2)b\df{31/ ) ): //12b123 
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s 電話 番号 や メー ル ア ド レス の 
と ナオ ok 4 人 ルナ セル スィ AP 





PART 前 節 ま で に 解説 し た 正規 表現 を 使用 し て 電話 番号 や メー ル ア ド レス な どの フォ ー マ ッ ト が 正 
し いか チェ ッ ク で きま す 。 こ こ で は 、 実 用 的 な サン ブル を いく つか が 紹介 し ます 。 


ActionScript3.0 正 規 表 更 に よる フォ ー マ ッ トチ ェ ッ ク 
目的 




























/ \d[{4] 年 \d[2] 月 \d{2] 日 / 











\d{4] は 4 桁 の 数 字 、\d{[2] は 2 桁 の 数 字 に 一 致し ます 。 








正規 表現 パタ ー ン の 例 








郵便 番号 


調べ る フォ ー マ ッ ト の 内 容 | nnn-nnnn 形 式 の 郵便 番号 形式 に 合致 する か 調べ る 。 
正規 表現 パタ ー ン の 例 / \d は }- \d{44/ 


3 











\d{3] は 3 桁 の 数 字 に 一 致し ます 。 

















調べ る フォ ー マ ッ ト の 内 容 | 2-4 桁 + 3-4 桁 + 4 桁 形 式 の 電話 番号 に 合致 する か 調べ る 。 
正規 表現 パタ ー ン の 倒 


般 


標準 的 な メー ル ア ド レス で ある か 調べ る 。 
正規 表現 パタ ー ン の 例 /([0-9a-zA-Z]+[-. +&])*[0-9a-zA-Z]+@([-0-9a-zA-Z+[」])+[a-zA-Z][2.6]/ 


目的 
回 へ > 0、。 じ へ ) 
解説 [0-9a-zA-Z]+ は 英 数 字 の 1 文字 以上 の 繰り 返し に 一 致し ます 。 
[-. +&] は [ ] 内 の いずれ か の 1 文字 に 一 致し ます 。 
( )* は ( ) 内 を グル ー プ と し て その 繰り 返し が 0 以上 ある 場合 に 一 致し ます 。 
調べ る フォ ー マ ッ ト の 内 容 | 正しい URL で ある か 調べ る 。 
正規 表現 パタ ー ン の 例 
\w は a ー z、 AA て ZZ、0 て 9、 に 一 致し ます 。 


@ は この 位置 に "②" が ある 場合 に 一 致し ます 。 
解説 
[ ]+ は [ ] 内 の 文字 の いずれ か が 1 つつ 以上 繰り 返す 場合 に 一 致し ます 。 


( )+ は ( ) 内 を グル ー プ と し て その 繰り 返し が 1 以上 ある 場合 に 一 致し ます 。 
[a-zA-Z][2.6) は アル ファ ベッ ト 文 字 が 2 以上 6 以下 繰り 返す 場合 に 一 致し ます 。 

注意 : 上 記 の 正規 表現 パタ ー ン は 多く の ケー ス で 使用 で きる 1 つの 例 で 、 完 全 な フォ ー マ ッ ト チ 

104 ェ ッ ク を 行う も の で は あり ませ ん 。 





/ \d{Z.4|- \d{3,4|- \d{44/ 














\d{2,.4] は 2 桁 以 上 4 桁 以 下 の 数 字 に 一 致し ます 。 











メー ル ア ド レス 
































/http: \/ \/[ \d Me. \/ , $I"O: の =8Hl+/ 






\/ は 「/」 と いう 文字 が その 位置 に ある 場合 に 一 致し ます 。 
\d は 0- 9 の 数 字 に 一 致し ます 。 

















日 付 
調べ る フォ ー マ ッ ト の 肉 容 | nnnn 年 nn 月 nn 日 の 形式 に 合致 する か 調べ る 。 


目的 
と To ので 
に ーー ュ で | 


RE も US も S も も SBSSSSSESSSS 和 KS は JNES333303300600 へ く へ ぱ ぽ ぱ コ へ RE 


= ある = 画 コ 首相 mp】 ヨ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


フォ ー マ ッ トチ ェ ッ ク を 行う 正規 表現 サン ブル RegExpSampileG.fla 


/ / 指定 書式 の 検索 

var 802 :Strinqd = 『" 後 の 2011 年 10 月 10 日 に 〒170-0013 に 手紙 を 書き 、090 -1111-2222 に 電 
話し ます 。" : 

/ / 日 付 (nnnn 年 nn 月 nn 日 の 形式 ) 

traoce( gs02.match( /\d{4) 年 き d{2} 月 \d{2) 日 / ) ): 

/ / 郵便 番号 

trace( gs02.match( /\d{31-\d{41/ ) ): 

/ / 電話 番号 (2-4 柏 + 3-4 桁 + 4 桁 ) 

trace( gs02.match( /\d{2,4)-\d{3,4)-\d{41/ ) ): 





// メ ー ル アド レス の チェ ッ ク 
Var ma11 :St 上 rinmd = " エ miya-ta@ma11 .websygd .Com" : 
Var badMai1 : St 上 rind = " エ m1ya-a .ma11] .Websygsd .Com'" : 


Var ema1i] :RedExDp = /([0-9a-zA- 紀 ]+[- . +&] ) *[0-9a- zA-Z] +@ ( [-0-9a-zA- 


2+[.])+[a-2A- る 1 12.61/: ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ゆ 
traCe( ma1l1l + " : !+ ema1t1.tegt( mai1] ) ): 

trace( badMa1il + " : !+ emai1].teg ( badMai1] ) ): 

/ /URL の チェ ッ ク 

Var ur :Strinq = "htp : / /www . websy8d . Com" : 


var badUr1 : Str1nd = "FtPp://Www .1t-schoo1 . ord『" : 
Var U エ 1] :RedEXD = /htD: ぎ / ぎ /[\ ぎ dwW- . ま /,S1*!() : :@=&+] +/ : 
も お 導 科 ME まま Ws 生ま 0 上 も ea (は Z よ よ )」 


trace( badUr] + ! : !+ Ur1.tegt ( badUr] ) ): 


の email:RegExp で は ( ) に よる グル ー プ を 作成 し て いま す 。 


実行 結果 
2011 年 10 月 10 日 
170-0013 
090-1111-2222 
 m1ya-a@ma1 1 .Websy8d .Com : 上 rue 
r m1ya-a .ma11 .Websysd.Com : fFa]gse 
ht て tb : / /Www . websygd .Com : 上 rue 


Ftp : / / www . 1 上 - schoo1 .orq : fal]gse 
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5 一 3 テキ スト フィ ー ル ド 
テキ スト フィ ー ル ド の 種類 と 


クラ ス を 把握 する 





PART Flash の テキ スト ツー ル (T) で ステ ー ジ 上 に 配置 し た テキ スト の うち 、 ダ イナ ミッ ク テ キ スト 、 
また は テキ スト 入力 と し て 作成 し た オブ ジェ クト は AcdtionScript で flash.text.TextField ク ラフ 
ス の イン スタ ンス と し て 操作 で きる よう に な り ま す 。 こ れ ら の オブ ジェ クト は ActionScript コ 
ー ド で も 作成 可能 で す 。 静止 テ キス ト と し て 作成 し た オブ ジェ クト は ActionScript で 操作 する 
こと は で きま す が 、 こ の タイ プ の テキ ス トイ ンス タン ス は ActionScript で は 作成 で きま せん 。 

Flash CS5 か ら 、Flash Text Engine (FTE) を ベ バース と する Text Layout Framework (TLF) 
が 導入 され まし た 。 そ れ に 伴い 、 こ の Part で 紹介 する 従来 の テキ スト エン ジン に よる 処理 と コ 
ン ポ ー ネ ン ト は 、「 ク ラシック テキ スト 」 と 呼ば れる よう に な り ま し た 。TLF に つい て は 、Part6 
[高度 な テキ スト 処理 ] を ご 覧 くだ さい 。 





テキ スト ウール 
静止 テキ スト 。 
ダイ ナミ ッ ク テ キス ト 
テキ スト 入力 


カラ - , 装 請 議 凡 自 動 カ ーー ニン ガ 





和 苦 テキ スト ツー ル で 作成 で きる テキ スト の 種類 と 関連 する ActionScript3.0 ク ラス 
type プロ パテ ィ 


静止 テキ スト 実行 時 に 変更 で き な い 固定 的 な テキ スト に | StaticText 
な り ま す 。 静止 テキ スト は ActionScript で 
イン スタ ンス を 作成 する こと が で きま せん 。 











ダイ ナミ ッ ク テ キス ト | ユー ザ に よる テキ スト の 編集 / 入 力 は で き | TextField dynamic 
ませ ん が 、ActionScript で 操作 で きる テキ 
スト に な り ま す 。 








テキ スト 入力 ユー ザ が 編集 / 入 力 で き 、ActionScript に Input 
よる 操作 も で きる テキ スト に な り ま す 。 


※type プ ロ パ ティ は TextField ク ラス の も の で 、 ダ イナ ミッ ク テ キ スト か テキ スト 入力 か を 決定 
し ます 。 
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5-3- 1 
テキ スト フィ ー ル ド の 種類 と クラ ス を 把握 する 


= を 2 明 間 ヨコ - -- - ----------------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 









CB 天 O 昌 O デバ ッ ク 0 
これ は 静止 テキ スト : 静止 テキ スト は 通常 ActionScript で 処 理 し ませ ん ,。 


これ は テキ スト 入力 (name = inpText_txt J 


inpText_txt 


dynText txt 











これ は ダイ ナミ ッ ク テ キス ト (name = anText_txt) 







テキ スト 入力 は TextFieid オ ブ ジ ェクト が (inpTex_txt is TexField)=true 

巡 イ ナミ ッ カ テキ スト は TextField オ ブ ジ ェクト が (dynText_txdt is TextField)=true 
テキ スト 入力 

ダ イナ ミッ ワウ テキ スト の type=dynamic 


msg_textArea 
(TextArea コン ポー ネン ト ) 


= を る 上 コ 浮 コ 疾 中 mp】 ヨ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


テキ ス ト フ ィ ー ル ド の 種類 を 





= 14 


いで は 、 画 面 上 部 の 2 つの テキ スト (inpText_txt と dynText_txt) が TextField ク ラス の イン 
スタ ンス か どう か を is 演算 子 で 判定 し 、② で は それ ぞ れ の テキ スト の type プ ロ パ ティ の 値 を 詩 





べ て いま す 。 そ し て 結果 は msg_textArea と いう textArea コ ン ポ ー ネ ン ト に 出力 し て いま す 。 
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2 テキ スト フィ ー ル ド オ プ ブ ジ ェクト を 
使う 





PART 
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画面 か ら 入 力 さ れ た テキ スト 内 容 を 処理 し た り 、 テ キス ト を ActionScript で 作成 し て 表示 す 
る に は 、TextField ク ラス を 使用 し ます 。TextField ク ラス に は 次 の ひよ うな プロ バテ ィ が 用 意 さ 


れ て お り 、ActionScript で 処理 を 


名 extFieldi ン フィ く の 主 な プロ バテ イ 








| 目的 
自動 的 に 拡大 / 縮 小 、 





加 列 す 








ューーー 一 


育 景色 を 指定 


ミユ 





6 上 1nd 














ー 


境界 線 を 表示 / 非 表示 に する 


u1n ロ 人 





っ 生 > 性 に し 、 


を に 


| 1 
- ' | デー ィ ィ ー と 1 了 
り コ て し 4 上 # し 4 


と が で きま す 。 








“ ' 
プロ パテ ィ の 概要 








テキ スト フィ ー ル ド の 自動 的 な サイ ズ 変 更 
と 整列 を 制御 し ます 。 次 の 値 を と る こと が 


| で き ます 。 


TextFieldAutoSize.NONE (デフ ォ ル ト ): 
サイ ズ 変 更 を 行い ませ ん 。 
TextFieldAutoSize.LEFT : 左 揃 え テ キス ト 
と し て 右 マ ー ジ ン が 伸縮 し ます 。 
TextFieldAutoSize.RIGHT : 右 揃 え テ キス 
ト と し て 左 マ ー ジ ン が 伸縮 し ます 。 
TextFieldAutoSize.CENTER : 中 央 揃え テ 


キス ト と し て 左右 の マー ジン が 伸縮 し ます 。 











境界 線 の 色 を 指定 する 








カー ソル の 位置 を 調べ る 


1 








パス ワー ド 入 力 用 に する 


html を 表示 する 











| 文字 数 を 調べ る 














| 複数 行 を 表示 可能 に する 





| 入力 で きる 文字 数 を 制限 する 





Boolean 








FQer : Boolean 


| FFFFFF) で す 。O0x は 16 進 数 を 表し ます 。 





RGB カ ラー 
育 景色 を 設 


値 に より テキ スト フィ ー ル ド の 
定 し ます 。 デ フォ ルト は 白 (Ox 





true : 境界 線 を 表示 し ます 。 
false : 境界 線 を 表示 し ませ ん (デフォルト )。 





F : u1m ヒ 


ndex : 1n ヒ 





| 現在 カー 





RGB カ ラー 値 に より テキ スト フィ ー ル ド の 
境界 線 色 を 設定 し ます 。 デ フォ ルト は 黒 (O0x 
000000) で す 。0x は 16 進 数 を 表し ます 。 


ソル が 置か れ て いる 位置 を 示し ま 


す 。 





WOrQ : Boo」ean 





true : 入力 文字 は アス タリ スク 表示 され ま 
記 


false : 入力 文字 は その まま 表示 され ます 。 





に :SE 了 ア エ n 








基本 的 な タグ に よる HTML を 表示 で きま す 。 





* を や れ < 1 生 








テキ スト フィ ー ル ド の 文字 数 を 返し ます 。 





「] 避 」 ) 1 配 








演 朱 基 下 ジィ ーbI に 入力 で きる 最大 文字 
数 を 設定 で きま す 。0 の 場合 、 文 字数 は 無 制 


限 と な り ま す 。 





true : 複数 行 の テキ スト を 表示 、 編集 可能 


で す 。 





false : 単 一 行 の 表示 、 編 集 を 行い ます 。 














5-3-2 
テキ スト フィ ー ル ド オ ブ ジ ェクト を 使う 


怠 TextField クラ ス の 主 な プロ パテ ィ ( 続 き ) 


文字 を 選択 可能 / 不 可能 に する | se1ectab1e : true : 文字 は 選択 可能 に な り ま す 。 
文字 の コピ ー を 制限 する Boo1ean false : 文字 を 選択 で き な く な り 、 コ ピー で 



















きま せん 。 
入力 で きる 文字 を 制限 する reStriot:Strind | テキ スト フィ ー ル ド に 入力 で きる 文字 を 設 
定 さ れ た も の の み に 限 定 し ます 。 
スタ イル シー ト を 関連 づけ る | sty1eSheet : テキ スト フィ ー ル ド に スタ イル が 定義 され 
StyleShee た StyleSheet オ ブ ジ ェクト を 関連 づけ て ス 
タイ ル を 利用 可能 に し ます 。 





文字 列 全 体 を 取得 / 設 定 す る | text :String 


テキ スト フィ ー ル ド 内 の プレ ー ン テキ スト 
を 取得 で きま す 。 こ の プロ パテ ィ で 表示 す 


る 文字 を 設定 で きま す 。 


RGB カ ラー 値 に より テキ スト の 色 を 設定 し 
ます 。 デ フォ ルト は 黒 (0x000000) で す 。 
0x は 16 進 数 を 表し ます 。 


TextFieldTVpe.DYNAMIC : ダイ ナミ ッ ク 
テキ スト フィ ー ル ド と し て 働き ます 。 実際 
に セッ ト さ れる 値 は dinamic で す 。 

TextFieldTVpe:INPUT : テキ スト 入力 フィ 
ー ル ド と し て 働き ます 。 実際 に セッ ト さ れ 
る 値 は input で す 。 


true : 文字 列 の 幅 が テキ スト フィ ー ル ド よ 
り 長 い 場 合 、 折 り 返 し て 表示 し ます 。 
false : 折り 返し し ませ ん 。 




















tex 七 Co] or : u1n ヒ 







文字 色 設 定 / 取 得する 
















テキ スト フィ ー ル ド の タイ プ 
を 取得 / 設 定 する 


tyDe : S 上 rind 








文字 列 の 折り 返し を 行う 


wordWrap : Boolean 











息 TextField クラ ス の 主 な メソ ッ ド 


ーー 白 


文字 列 を 追加 する appendTex テキ スト フィ ー ル ド の 未 尾 に テキ スト を 追 
加 し ます 。 

選択 され た 文字 列 を 置き 換え る | rep1aceSe1ected | 現在 選択 され て いる 範囲 の 文字 列 を 置き 換 

T 己 訪 沈ま 。 

指定 し た 範囲 の 文字 列 を 置き 換 | rep1aceTexx 開始 位置 と 終了 位置 を 指定 し て 文字 列 を 置 

える き 換 えま す 。 

範囲 を 指定 し て 文字 を 選択 する 開始 位置 と 終了 位置 を 指定 し て 文字 列 を 選 
択 し ます 。 
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PART 
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5-J 
テキ スト フィ ー ル ド 


ウ TextFieidSampleB.swf Sa 
| ファ イル (FE) 衣 示 y) 血 御 (CO デバ ッ グ 6) 


ダイ ナミ ッ ク テ キ スト : 新しい 文字 列 を 設 宝 し まし た 
テキ スト 入力 入力 され た テキ スト は tex せ プロ パテ ィ で 取得 で きま す 。 





= を る 上 コ 画 コ 疾 mmlp】 ヨ 蘭 -- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


ステ ー ジ 上 の ダイ ナミ ッ ク テ キス ト に 文字 列 を 表示 し て テキ スト 入力 に TextFieldSampleB.fla 


入力 され た 文字 列 を 取得 する 
dynText txt .addaEventListener( MouseEvent .CLTCK, setText ) : ーーーーーー-① 
FumCt1on getText (event : EVerit ) :Yo1d { 一 一 ーーーーーーーーーーーーーーーーーーーーーーー- ②) 
dynText tx .Eext = "新しい 文字 列 を 設定 し まし た 『: 
) 
1npText xt .addEventListener( Event .CHANGE, showText ) : ーーーーーーーー③ 


Function showText (event : Even ) : od { 


Output xx も .Eext = 『 ダ イナ ミッ ク テ キ スト : " + dymTexxt txt.Eext + "\m テ キス ト 入 
力 : " + mpTexxt Ex. て ex : 一 一 一 ーー ④ 


の 設定 で ダイ ナミ ッ ク テ キス ト (dynText_txt) が クリ ッ ク さ れ た と き に setText() 関 数 を 呼 


び 出 し 、⑧ の 処理 で そこ で 表示 する 文字 列 を 更新 し ます 。 


3③ の 設定 で inpText_txt に 入力 が ある と showText() 関 数 が 呼び 出さ れ ま す 。④ で text プ ロ パ 


ティ に より 、TextField オ ブ ジ ェクト か ら テ キス ト を 取得 し て いま す 。 


入力 用 の テキ スト フィ ー ル ド を 作る 





TextField ク ラス の プロ パテ ィ 設 定 に より 、 入 力 用 の テキ スト フィ ー ル ド を アレ ンジ で きま す 。 
テキ スト 入力 に 関連 する プロ バテ ィ と その 詳細 は 下 表 の よう に な り ま す 。 


御 TextField クラ ス の テキ スト 入力 に 関す る プロ パテ ィ 詳 細 


border : Boo1ean テキ スト 入力 の 境界 線 を 表示 し ます 。 入力 ボ ックス の 場合 、 境 界 線 が 必要 と 
な る た め 、 通 常 は true に し ます 。 プロ バ パティ イン スペ クタ で も 設定 で きま す 。 
1 














disp1ayAsPassword | パス ワー ド 入力 用 の テキ ス ト 入 力 の 場合 、 true に し て 入力 文字 を ア スタ リ 
: Boo1ean スク で 表示 し ます 。 入力 され た 文字 列 は text プ ロ パ ティ で 取得 で きま す 。 


ーー サーーー 
maxChars : 1nt テキ スト 入力 に 入力 可能 な 最大 文字 数 を 指定 で きま す 。 デ ー タ ベー ス に 格 
納 す る 場合 な ど に フィ ー ル ド の テキ スト 長 を 超え な いよ うに で きま す 。 


























multi1ine:Boolean | HTML の <input type="text'> の よう な 上 単 一 行 入力 を 行う と き に は false に 、 
<TextArea>z の よう な 複数 行 入力 を 行う と き は true に し ます 。 











ELex : 5 上 1nd 入力 され た 文字 列 を 取得 で きま す 。ActionScript で この プロ パテ ィ に スト 
リン グ を セッ ト し て テキ スト 入力 の 文字 列 を 設定 で きま す 。 

ype : Str1mng ダイ ナミ ッ ク テ キス ト か テキ スト 入力 か を 決定 し ます 。 テ キス ト 入 力 の 場 
合 、"input'" に し ます 。 こ の 値 は TextFieldType ク ラス に INPUT と いう 定数 で 





も 定義 され て いま す 。 


wordWrap:Boolean | テキ スト エリ ア と し て 複数 行 の 入力 を 行う 場合 、 入 力 テ キス ト が テキ スト 
フィ ー ル ド の 右端 で 折り 返し 改行 させ る に は 、true に 設定 し ます 。 デ フォ 
ルト は false な の で 、 設 定 が 必要 で す 。 プ ロ パ ティ イン スペ クタ の 「 タ イプ 」 
で 設定 も で きま す 。 




















に 2 画 ヨコ 議 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ファ イル (FE) 表示 (V) 古 御 ( 〇 C デバ ッ グ (D) 


HTML テキ スト ガ 「 含 れる テキ スト フ 1 MFP の 赤 人 な 日 ス 
A、 改行 な おど) を 削除 す うか を 指定 する ブー ル 値 で 
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5-3 
テキ スト フィ ー ル ド 





= あ 和 1 目 = 首 村 ml5】 コ 蘭 --- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


テキ スト フィ ー ル ド の プロ パテ ィ を ActionScript で 設定 する TextFieldSamplet.fla 


// お 名 前 テキ スト 入力 の 設定 

PART name ヒヒ .type = TextF1ie1dType . INPUT : 
mame ヒヒ .bOrQer = TUG: 
name xt .baCkqdrOund = 上 FUG: 


name 上 xt .baCkqrOoumndCOo1Or = OXFFEFFEF: 


// パ スワ ー ド テキ スト 入力 の 設定 
Pa88word 上 xt .type = TextF1ie1dType . INPUT : 
Pa88wOrQ xt .DOrQer = YUG: 
Pa88worQd txt .displayASPa88worQ = TUG: 
Pa88worQ xt .DaCkqdrOunQ = 上 TUG: 


Pa88word 上 xt .DackqgroumnQCO1Or = OXFFFFEF: 


/ / コメ ント テキ スト 入力 の 設定 

Comment x .type = TextF1ie1dType . INPUT : 
COmmen 七 ヒヒ .DOrQer = TUe: 
Commen 七 上 xt .wOrQWraD = TUG: 
Commen セ x モ .maxChars = 100: 
COmmen 上 xt .DaCkdrOumd = 上 エ UG:』 


CoOmmen ヒ 上 .DacCkdrOundCO1Or = OxEFFFFEF: 


/ / ボ タン ハン ドラ 関数 
Funotion sendMsg ( event :MouseEvent ) :void { 
trace ( "お 名 前 =" + name xt .Eext + "\n パ スワ ー ド =" + pa88worQd xt . 
も 旬 光 も + 
り 党 n コ メン ト = " + Commen txE. も ext + "(" + COmment xt .1ength + 
て 


// イ ベン トリ スナ ー の 登録 
send btn .addEventListener( MouseEvent .CLTCK, sendMsd ): 


ー 部 の プロ パテ ィ は プロ パテ ィ イ ンス ペク タ で 設定 で きま す が 、ActionScript で すべ て の 設 
定 を 行っ て いま す 。 ① で 入力 され た テキ スト と コメ ント の 長 さ を 取得 し て いま す 。 
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エア ヤ きも , ァ レア た つづ) 月 に 
入力 で きる 文字 を 制限 する 


電話 番号 や メー ル ア ド レス な どの テキ スト 入力 で は 、 入 力 さ れ た 文字 列 に 不正 な 文字 が な い 
か が チェック する 必要 が あり ます 。 そ の 場合 、 入 力 後に チェ ッ ク を 行う より も TextField ク ラス 
の restrict プ ロバ ティ で 入力 フィ ー ル ド 自 体 に 入力 制限 を 設け る こと が で きま す 。 





委 「extField クラ ス の テキ スト 入力 文字 を 制限 する プロ パテ ィ 


| 5g? | mom 


電話 番号 の 場合 は 数 字 と 括弧 ( ) の み 」、「 郵 便 番号 の 場合 は 数 字 と ハイ フン (-) 
の み 」 と いう よう な 入力 文字 の 制限 を 行う こと が で きま す 。 文字 の 範囲 を ハイ 
フン (-) で 指定 で きま す 。 カ レッ ト (②⑳ で 除外 する 文字 を 指定 し ます 。 次 の よう 
な 設定 が で きま す 。 
"あい うえ お "  :「 あ 」 て 「 お 」 まで の 文字 の み の 入 力 を 許可 し ます 。 
" あ - ん " ・ ひら が な の み の 人 入力 を 許可 し ます 。 
" あ - ん ア - ン " ・ ひら が な と カタ カナ の み 入 力 で きま す 。 
"0-9a-zA-Z()@" : 数 字 と 英字 、()@ の み 入 力 で きま す 。 
" あ - ん ^ た " :「 た 」 を 除く ひら が な を 入力 で きま す 。 
m0-9\\-" : 0 て 9 の 数 字 と ハイ フン (-) を 入力 で きま す 。 ハ イフ ン (-) は 
男 肝 を 表す 記号 な の で 、\\ を つけ て エス ケー プ す る 必要 
が あり ます 。 そ の 他 、 カ レッ ト (⑳ は \\^、 円 記号 は \\\\ 
と いう 表記 に な り ま す 。 








TextFieldSampleD.swf 
ファ イル (F) 表示 (V) 司 御 (CO デバ ッ グ (D) 
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5-J 
テキ スト フィ ー ル ド 


ーー 


TextField クラ ス の restrict プロ パテ ィ を 使う TextFieldSampleD.fla 


/ / 郵便 番 号 の restr+1ct 設 定 
PART Z1D xx 上 .YGg8 上 iC も = "0-9W ぎ - リ : 2m be 内 








/ / 電 話 番号 の regtr1ict 設 定 
phone ヒ xt .re8tr1iot = "0-9()・ ぼ - リ : ーーーーーーーーーーーーーーーーーーーーーーー ① 





// メ ー ル アド レス の regtr1ict 設 定 
簡 負 ます も も や の きも ど ユ で も an 0 この 人 こ 到 大 = 衝 導 基 =、 キ 仁 伸 7 す ーーーーー デ ーーー * ① 








/ / カ ナ の regtr+ict 設 定 


旬 上 モバ ヒ 。 で @ き も エ よ GE m "アーン ジン") 


// テ キス ト を 取得 する ボタ ン ハ ンド ジラ 関 数 
Function ohk (event : MouseEvent ) :vo1d { 
1F ( kana xt .1ength == 0O ) returT: 
regu1t txt.Eext = kana txt.Eext + "さん 、 選 入力 あり が こと う ご ざい まし た 。 ぎ #m! 
す 半生 も 光 も 。 旬 林 拓 才 
TE エ Li:  + DhOne ヒ XE 上 eX ヒ + " ま + 


ma1] : + ma xt .Eex : 


// イ ベン トリ スナ ー の 登録 
chk btn.addEventListener( MouseEvent .CLhTCK, chK ): 


① で ハイ フン (-) を 入力 する た め の エ スケ ー プ を 行っ て いま す 。 


114 


5 ActionScript で テキ スト の 
フォ ー マ ッ ト を 設定 する 





TextField ク ラス で は プロ パテ ィ で テキ スト の 色 と 背 景色 を 設定 で き を ます が 、 フ ォ ン ト サ イ 
ス や イン デン ト 、 マ ー ジ ン の よう な 詳細 フォ ー マ ッ ト は TextFormat ク ラス を 使用 する か 、CSS 
を 使用 し て 設定 で きま す 。 ま た 、HTML の 基本 タグ を 使用 し て フォ ー マ ッ ト す る こと も で きま 
す 。 こ こ で は 、TextFormat ク ラス を 使用 する 方 法 を 解説 し ます 。 


甘 ActionScriDt で テキ スト の フォ ー マ ッ ト を 設定 する 方 法 


に nm ls 


TextFormat ク ラス | ActionScript で TextFormat オ ブ ジ ェクト を 作成 し て TextField の defaultTextFor 
mat プ ロ パ ティ に 設定 する か 、setTextFormat() メ ソ ッ ド に 渡し て 設定 し ます 。 
| | プログ ラム 実 行 中 に 動 的 に フォ ー 一 ツ ト 麗 定 を 行う と き に 適し て いま す 。 


CSS HTML で 使用 する CSS プ ロ パ ティ と 同様 の も の を Flash で 使用 で きま す 。 Style 
Sheet オ プ ジ ェ クト を 生成 し て 動 的 に CSS ス タイ ル を 割り 当て る 方 法 と 、 外 部 
じ S ら ファ イル を 読み 込む 方 法 が あり ます 。 


HTML HTML の 基本 タグ に よる テキ スト の フォ ー マッ ト を 行い ます 。 AUOSBHIDR 古 | 
ーー ここ ー ダ ッ ト 行 うこ と が で きま すず す 。 























- ゴ 





























上 TextFormat ク ラス の 主 な プロ / テイ 


| 0 プロ パテ ィ 名 | プロ パティ の 哲 要 1 


段落 の ア ライ ン メ ント 設定 ョ 11qn:String | 段落 に 左 ( デ フォ ルト )、 右 、 中 央 、 均 等 割り 付け 
を 設定 で きま す 。 段 落 は 改行 で 区 切ら れ た ブロ ッ 
ク で す 。 設定 値 は TextFormatAlign ク ラス に 定数 
で 定義 され て いま す 。 

TextFormatAlign.LEFT  : 左 寄せ 
TextFormatAlign.RIGHT  : 右 寄せ 
TextFormatAlign.CENTER : 中 央 寄せ 
TextFormatAlign.JUSTIFY : 均等 割り 付け 

















全体 の イ ン デ ント 設定 b]ockTndent : TextField 全 体 の イン デン ト を ピク セル 単位 で 設 
Ob]j eo 定 で きま す 。 











ーーーー サ オー = 


テキ スト を ボー ルド に する bo1d :Ob]ect true の 場合 、 テ キス ト の 書式 を ボー ルド に し ます 。 




















テキ スト の 色 を 変え る Co1Oor:Ob]ect | RGB カ ラー 値 に より テキ スト の 色 を 設定 し ます 。 
デフ ォ ル ト 値 は null で す が 、Flash Player で は 黒 
(0x000000) が 使用 され ます 。O0Ox は 16 進 数 を 表 
し ます 。 

フォ ント を 指定 する FonE:String | フォ ント 名 を 示す 文字 列 を 指定 し ます 。 例 えば デ 


バイ ス フ ォ ント を 使用 する に は 、" ゴシック "を こ 
の プロ パテ ィ に 設定 し ます 。 











段落 先頭 文字 の イン デン ト 設 | ndent : 段落 の 先頭 文字 の 左 マ ー ジ ン か ら の イン デン ト を 


定 Ob] ec | 整数 で 設定 し ます 。 
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PART 
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5-3 
テキ スト フィ ー ル ド 


怠 TextFormat ク ラス の 主 な プロ パテ ィ ( 続 き ) 


テキ スト を イタ リッ ク に する | ita1ic: true の 場合 、 テ キス ト の 書式 を イタ リッ ク に し ま 
Ob] ec す 。 


カー ニン グ を 有効 に する kern1ind : true の 場合 、 カ ー ニ ング が 有効 に な り 、 文 字 が 読 
Ob] ec みや すく な り ま す 。 た だ し 、 埋 め 込み フォ ント に 
の み 適 用 され ます 。 


段落 の 左 マ ー ジ ン 設 定 1eftMard1n : 段落 の 左 マ ー ジ ン を ピク セル 単位 で 設定 し ます 。 
Ob] ec 上 

文字 間隔 の 調整 1etterSpacing: | すべ て の 文字 の 間隔 を ピク セル 単位 で 指定 で きま 
Ob]j ec す 。 小 数 点 つ き の 数 値 を 使用 で きま す 。 

段落 の 右 マ ー ジ ン 設 定 rightMargin: | 段落 の 右 マ ー ジ ン を ピク セル 上 単位 で 設定 し ます 。 
Ob] ec 

テキ スト に 下線 を つけ る true の 場合 、 テ キス ト の 書式 を 下線 つき に し ます 。 




































unQderl 1ne : 
Ob]ec 









-3-5.ActionScript で テキ スト の フォ ー マ ッ ト を 設定 する 
extField ク ラス で は プロ パテ ィ で テキ スト の 色 と 背景 色 を 設定 で きま す 
が 、 フ ォ ン ト サ イ ズ で イン デン ト 、 マ ー ジ ン の よう な 詳細 フォ ー マ ッ 
| (は TextFormat ジ ラス を 使用 し ます 。 よ く 使 用 され る フォ ー デ マッ | 
ブロ バテ ィ に は 下記 の 表 の も の が あり ます 。 









メチ 症 議 フォ ント 小三 コシ ッ ク ロ <| サイ ズ 19 。 を 剛 ポ - 放 


へ AMPLE ビ ロ ロ ヒ EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEkidididi 


TextFormat を 使用 する シン ブル な テキ スト エディ タ TextFormatSampie.fla 


/ / ス タイ ル を 保存 する 変数 

Yar myCo1or:uinE = Ox000000: 

Yar myFontName : String = " ゴシック リ ": 

Ya myEFontS1ze :NumDer = 18: 

Yar myBo1d:Boo1ean = fa186: 

/ /TextFormat 上 オブ ジェ クト 

var myTextFormat : TextFormat = new TextForma () : 
/ /TextFie1d の プロ パテ ィ 設 定 


ら -3-5 
ActionScript で テキ スト の フォ ー マ ッ ト を 設定 する 


ed1tor て xt .mul 上 1]1ne = true: 
eQ1tor xt .WordWrap = rue: 
// イ ベン トリ スナ ー の 登録 
Col1orP1ocker . addEventTLiistener ( Event .CHANGE, setCo1or ) : 
FontCombo . addEventListener ( Event .CHANGE, setFontName ): 
81zeNumericStepper . addEventTLi1stener ( EVent .CHANGE, setFontSize ): 
bo1dCheckBox . addEventListener ( Event .CHANGE, setBo1d ) 
// イ ベン トリ スナ ー 
Funct1on SetCo1or (event : Event ) : Yo1d { 
myCo1or = で ColorPioker . selectedCo1or : app1yFormat ( ) : 
Function setFontName (event : Event ) :vo1d 1 
myFontName = fontCombo . selectedTtem . daa : apPp1yForma ( ) : 
) 
Funot1on setFonES1 ze (event : Event ) :Yoid { 
myFonES1ze = sizeNumer1CStepper .Ya1ue : app1yFormat ( ) : 
) 
Funct1on setBo1d (event : Event ) :void { 
myBo1d = bo1dqdCheockBox . seleoted : app1yFormat ( ) : 
) 
/ / スタイル を 設定 する 関数 


Function app1yFormat ( ) :void 1 


1f ( editor xt .seleotionBeg1nTndex == editor xt . 
selectionEndTndex | | 
ed1tor xt .se1eotionBeg1nTndex > editor xt .1ength | | ① 


editor tx .se1eotionEndTndex == 0 || 

ed1tor xt .seleotionEndTndex > editor xt .1ength ) return: 
myTextFOrmat .Co1Or = myCo1or: 
myTextFOormat . 上 Font = myEFontName : 
myTexEFOrmat .S1ze = myFontS1ze 


myTexFOormat .bo1d = myBo1dqd: 





ed1tor 上 xt .setTextFormat ( myTextForma , ed1tor xt . 


select1onBeg1nTndex, editor xt .seleotionEndTndex ): 


で は 、 選 択 男 が な か っ た と き な ど に 処理 を 中 断 し て いま す 。② で TextFormat オ ブ ジ ェ 
クト の プロ バテ ィ を 設定 し て TextField の 選択 範囲 に 割り 当て を 行っ て いま す 。 
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HTML テ キス ト を 表示 する 





sar 。 TextField オ ブ ジ ェクト は 基本 的 な HTML タ グ を サポ ー ト し て お り 、HTML に よる 書式 の 設定 
を 行う こと も で きま す 。 サ ポー ト さ れる タグ と 属性 は 下 表 の と お り で す 。 


軌 ActiOnSCcript3- 0 の TextField オ ブ ジ ェ ク ト で サポ ー ト で れる HTML タ ク 




































































| タグ | サポ ー ト され る 属性 と 必要 事項 
く > - | target :_self、_DlanK、 parenit、 _top を 指 下 定 で きま す 。 
href  : URL と ActionScript ink イ ベン ト を 指定 で きま す 。 
更 | フォ ント が ポー ルド 書体 を サポ ー ト し て いる 必要 が あり ます 。 
| . 二 」 TextField の multilines プ ロ パ ティ が true で ある 必要 が あ り ま す 。 ーー 
| <fon セ | color : 16 進 数 の カラ ー (#FFFFFF 形 式 ) 値 の み 使 用 可 能 で す 。 


face : フォ ント 名 を 指定 し ます 。 カ ンマ で 区 切ら れ た フォ ント 名 の 一 覧 を 指定 し た 
場合 、Flash Player は 最初 に 利用 可能 な フォ ント を 選択 し ます 。 指定 し た フォ 
ント が ロー カル に イン スト ー ル され て いな いか 、 組 み 込ま れ て いな い 場 合 、 
代替 フォ ント が 選択 され ます 。 

size : フォ ント の サイ ズ を 整数 で 指定 し ます 。 絶対 ピ クセ ル サ イ ズ (12 な ど )、 相 対 

| ポイ ント サイ ズ (+1 な ど ) を 使用 で きま す 。 























<Imd> テキ スト は 、 埋 め 込 ん だ イメ ー ジ の 周囲 に 自動 配置 され る た め 、TextField の multi 

lines プ ロ パ ティ が true で ある 必要 が あり ます 。 

SrC : イ メー ジフ ァイル 、SWF フ ァイル の URL、 ラ イブ ラリ 内 の ムー ビ 
ー ク リッ プシ ン ボ ル へ の リン ケー ジ 識 別 子 を 指定 し ます 。 

width :・ ピク セル 単位 の 幅 を 指定 し ます 。 

height : ピク セル 単位 の 高 さ を 指定 し ます 。 

align : イメ ー ジ の 水平 整列 を left (デフ ォ ル ト )、right で 指定 し ます 。 

hspace : イメ ー ジ 左右 の テキ スト が 表示 され な い 領 域 を 指定 し ます 。 デフ 
ォ ル ト 値 は 8 で す 。 

VsDaCce : イメ ー ジ 上 下 の テ キス ト が 表示 され な い 領 域 を 指定 し ます 。 デフ 
ォ ル ト 値 は 8 で す 。 

id : ActionScript を 使用 し て イメ ー ジ オブ ジェ クト を 処理 する た め の 
名 前 で す 。 

checkPolicyFile : true の 場合 クロ ス ド メ イン ポリ シー ファ イル (crossdomain.xmU 





を Flash Player が 確認 し ます 。 
<|> フォ ント が イタ リッ ク 体 を サポ ー ト し て いる 必要 が あり ます 。 





























<li> <o>、<ul> は 使用 で きま せん 。 
<D> TextField の multiines プ ロ パ ティ が true で ある 必要 が あり ます 。 


align : left、right、justify、center が 使用 可能 で す 。 
class : flash.text.StyleSheet オ ブ ジ ェクト で 定義 され る CSS ス タイ ルク ラス を 指定 
で きま す 。 


<SDan> CSS テ キス トス タイ ル で の み 使 用 で きま す 。 
| class : flash.text.StyleSheet オ ブ ジ ェクト で 定義 され る CSS ス タイ ルク ラス を 指定 
し ます 。 
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9 りー-③ー6 
HTML テ キス ト を 表示 する 


ゃ ActionScript3. 0 の TextField オ ブ ジ ェ ント で サポ ー ト され る HTML タグ (続き ) 
タク ィ ポ ー ト され る 属性 と 必要 事項 








| ai | TextFormat ク ラス の 段 沙 ノ オォ オー マ ッ ト プ ロ パテ ィ を html で } 生 征 で きま す 。 
| blockindent : ブロ ッ ク の イン デン ト を ポイ ント 単位 で 指定 し ます 。 
indent : 左 マ ー ジ ン か ら 段 落 の 先頭 文字 まで の イン デン ト を 指定 し ます 。 
| leading : 行 間 の 行 送り (垂直 の 行間 隔 ) を 指定 し ます 。 
leftmargin : 段落 の 左 マ ー ジ ン を ポイ ント 単位 で 指定 し ます 。 | 
| rightmargin : 段落 の 右 マ ー ジ ン を ポイ ント 単位 で 指定 し ます 。 
| tabstops 。 : カス タム タブ スト ッ プ を 負 以 外 の 整数 の 配列 と し て 指定 し ます 。 




















| <U> | フォ ント が ァ ンダ ー ラ イン を サポ ー ト し て いる 必要 が あり ます 。 














ン TextFieldSampleF swf Pe 
ファ イル (FE) 表示 (V) 叫 御 ( 〇 O デバ ッ グ (D) ビー 











AMPLE ビ ロ D ロ ヒ EEE 


耕 本 的 な HTML テキ スト を 表示 する 


html] xt .mult1]11ne = true: 

html xt.Dackqround = rue: 

html xt .backqroundCo1or = 0Ox000000: 

html txt .htm1Text = 

<tOnt CO1O エ =! 共 CCFFFF ! >&1 : Fontggt : タグ の co1or 属 性 は 16 進 数 の カラ ー 値 を 使用 可能 で す 。 
<D エ > + 

<a hret='http : / /adobe . com/ ' >&1t : a&g : タグ で URL を 指定 で きま す 。http : / / adobe . 
COm へ < /a><b エ > + 

<Db>glt:bggt : タグ </b> や <1i>g1t 1ggt : タグ < /1> で は フォ ント の サポ ー ト が 必要 で す 。<b ェ > + 
gl 上 :brggt: タグ は TextFie1d の mu1ti11ines=true で ある 必要 が あり ます 。<b ェ > + 

&1 : 1mg&gt: タグ も 使用 可能 で す 。<br><img SrC= ' htD : / /Www . websygd . com/ 1mg/ 

1 上]/1cons/earth . pg' height=!200! width=!200'><b テ > + 

</ Fon キ >: 
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7 HTML テ キス ト の ハイ パー リン ク で 
イベ ント を 発生 させ る 





PART TextField の htmlText プ ロ パ ティ に 設定 し た html テ キス ト の <a> タ グ で ActionScript イ ベン 
ト を 発生 させ る こと が で きま す 。 イ ベン ト が 発生 し た 場合 イベ ント ハン ドラ で 処理 で きま す 


せる <a> タグ 


暫 ActionScript3.0 の TextField オ ブ ジ ェクト で イベ ント を 発生 ご 


| タグ と 属性 | 説明 


| 





<a href> | href="eventimyText'" の 記述 に より 、 ハ イ パ ー リ ンク を クリ ッ ク し た と き に lext 
EventLINK イ ベン ト を 発生 で きま す 。 
myText に 指定 し た スト リン グ は 、 ハ ンド ラ に 渡さ れる TextEvent イ ベン ト オ ブ | 
ジェ クト の text プ ロ パ ティ で 参照 可能 に な り ま す 。 
ca href = "event: AS3.html> の リン ク を クリ ッ ク し た と き 、TextEvent オ ンタ 
| クト の text プ ロ パ ティ は "AS3.html"『 に な り ま す 。 


AE 


ウツ TextFialdSampleG.swf ょ つ P) 欄 際 人 剖 
| 「 ファ イル (F) 表示 (y) 制 衝 (CO デバ ッ グ (D) 





























較 ca href='event:ZoomUp'> 部 分 を 数 回 クリ ッ ク し た 後 の 状態 
| っ ii SD Image3 ・ 
、 ラ ァイル 0 。 才 0O 時 KO アバ ャ 0 











42 イイ ゴゴ" 

すま まま ます す ] 
きき | 
「 生 意 '! 
ま を LSE 





| | 署 評 
) 
き 

| 
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ひこ 9ー 7 
HTML テ キス ト の ハイ バー リン ク で イベ ント を 発生 させ る 


に たき 問 再 四 mp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


HTML テ キス ト の ハイ パー リン ク で イベ ント を 発生 させ て 処理 する TextFieidSampleG.fla 
Var 1mgS1ze:u1nEt = 200:  //1mg タ グ の heigqht、width 属 性 に 使用 する 値 


html 上 xt .mul ヒ 上 1]1ne = rUuG: 

html] xt .Dackqrounmd = rue: 

html Ext .backgroundCo1or = Ox000000: 

html] txt.selectab]e = fa]se: 

function setHtm1Text ( ) :void 1 
html] xt .htm1Text = 
<a hreft='event : ZoomUp ! >&1t:a hreF=!event : ZoomUp' &gt: は TextEvent . 
LTNK イ ベン ト を 発生 し ます < /a><br> + 


<a href='even : ZoomDown ! >&1t :a href='event : ZoomDowm " &qt : </a><b エ > 


3 





+ 
<1md 8 で ='hEtD : / /www . websysd . Com/ 1mg/1t]/icons/earth .]pg' height=" 
+ 1mgS1ze + "! width='!" + 1mgSize + "SW 
</ Fon>: 

) 

Function textL1nkHandler( event : TexEEvent ) { 一 ーーーーーーーーーーーーー-⑪ 
msgd xt .appendText ( "LTNK イ ベン ト :text=" + event .text + " ぎ \n" ): 
8w1toh ( event.text ) { 

Ca8e "ZOOmUD『" : 
1mqdS1ze += 10: 
break: 
Ca8e "ZOOmDoOwn!" : 
1f ( 1mgSize >= 10 ) imgSize -= 10: 
breaK : 


) 


setHtm1Text () : 


) 


html txt .addEventListener ( TextEvent .LTNK, textLinkHand1er ): 
8etHtm1Text ( ) : 


<a href='event:ZoomUp> を クリ ッ ク す る と "ZoomUp "が 、<a href='event:Zoom 
Down'> を クリ ッ ク す る と "ZoomDown "が TextEvent.text プ ロ パ ティ に 設定 され て 、Text 
Event.LINK イ ベン ト が 発生 し ます 。 か ら 始ま る イベ ント ハン ドラ で この text プ ロ パ ティ を 
調べ て 変数 imgSize の 値 を 更新 し ます 。 こ の 値 を 使用 し て img タ グ の height、width 属 性 を 設 
定 し な お し て 再び htmlText に セッ ト し ます 。 こ の 操作 に より 、TextField に 表示 され る イメ ー 
ジ の サイ ズ を ズー ム ア ッ プ / ダ ウン させ ます 。 
121 


CSS を 使用 し て テキ スト を 
フォ ー マ ッ ト す る 





PART 
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Flash で は TextField 内 の 文字 列 に 対し て CSS に よる テキ スト フォ ー マ ッ ト を 適用 で きま す 。 
flash.text.StyleSheet ク ラス の イン スタ ンス を 作成 し て 割り 当て る 方 法 と 、 外 部 の CSS フ ァ イ 
ル を 読み 込む 方 法 が あり ます 。 Flash Player で サポ ー ト され る CSS ス タイ ル は 下 表 の と お り で す 。 
スタ イル 名 の 規則 と し て 、CSS に 対応 する ActionScript プ ロ パ ティ 名 は 、 八 イフ ン を 往 ま な い 
も の に な り ま す 。 


StyleSheet クラ ス (Flash Player) で サポ ー ト で れる CSS スタ イル 
| プロ パテ ィ 名 | プロ バテ ィ 名 | 使用 可能 な 値 


| (CSS) (ActionScript) 




















Pa 
四 | 
ご 

















































































































































































































天 #FFOOFF の よう な 16 進 数 の カラ ー 値 の み 
"blue" な どの 名 前 付き カラ ー は サポ ー ト 
され ませ ん 。 

ト +ー = = am ] ー 
ボッ クス タイ プ Q1SD1ay 1SD1aY Inline、Dblock、none 
( 7 ト 名 Font -fFam11Y | TOnt 上 Fam11Y 任意 の フォ ント ファ ミリ 名 を 優先 度 の 高い 
| 順に カン マ 区 切り リス ト で 指 定 で きま す 。 
フォ ント サイ ズ ] TOn ロ 七 -81Z6 T On 上 ご ュ 126 単位 (Ox、 pt) を 除く 値 の 数 字 の 部 分 だ け | 
| を ピク セル 値 と し て 指定 し ます 。 

フォ ント スタ イル | fon 8 上 16 1 n 七 5 上 Ye normal、italic 

フォ シト ウェ イ ト | Fon 上 - we1dht1 FonEtWe1qht normal、bold 

カー ニン グ | KeGrn11d KGrT1Td | true、†alse 
埋め 込み フォ ント に 対し て の み サ ポー ト 
され て いま す 。 カ ー ニ ング は Windows で 
の み 設 定 可能 で す 。 設 定 さ れ た カー ニン 
グ は Windows 以 外 の バー ジョ ン の Flash | 
Player で も 表示 され ます 。 

' | “ | 

行間 隔 head1nd Lead1nd 単位 (px、 pt) を 除く 値 の 数 字 の 部 分 だ け 
| ビジ セル と し て 指定 し ます 。 

| 文字 間隔 L GEG ュ LletterSpacing | | 単位 (px、 Dt) を 除く 値 の 数 字 の 部 分 だ け 
Spacindq を ピク セル 値 と し て 指 定 し ます 。 
| | ee | 
GE 一 So mar1n-+ ら 上 { mar1nLhe 上 t 単位 (DX、 pt) を 除く 値 の 数 字 の 部 分 だ け | 
| を ピク セル 値 と し て 指定 し ます 。 
| 右 マ ー ジ ン margin | arg1n-r1ght | 単位 (px、pt) を 除く 値 の 数 字 の 部 分 だ け | 
right | を ピク セル 値 と し て 指定 し ます 。 
トド ンジ | ex -a11qm LexEA] 1qn left、center、right、justify 
テキ スト 装飾 text EextDecoration | none、underline 
| 1 ハデ スコ † ェ 1 

イジ チッ ルド | Lex- ユ ndent | ex 上 TnQent | 単位 (pxX、 pt) を 除く 値 の 数 字 の 部 2 分 だ け 

| を ビク セル 値 と し て 指定 し ます 。 




















りー3ー8 
CSS を 使用 し て テキ スト を フォ ー マ ッ ト す る 


音 TextField クラ ス の スタ イル シー ト 設 定 の た め の プ ロ パ ティ 詳細 


StyleSheet: | スタ イル が 定義 され た StyleSheet オ ブ ジ ェクト を TextField オ ブ ジ ェクト に 関連 づけ 
StyleSheet | を し ます 。 この プロ パテ ィ を 変更 し て 別 の StyleSheet オ ブ ジ ェクト を 割り 当て る と Te 
xtField は 再 描画 され て 新しい スタ イル が 適用 され ます 。 


スタ イル が 設定 され た TextField 内 の テキ スト は 編集 で きま せん 。 そ の た め 、type プ 
ロ パ ティ は TextFieldType INPUT で は な く 、TextFieldType.DYNAMIC に し ます 。 


























第 TextFormat ク ラス の シー ト 設 定 の た め の メ ソ ッ ド 詳細 


SetSty1e 動 的 に スタ イル プロ パテ ィ を 設定 し た Object オ ブ ジ ェクト を styleObject 
(StyleName : Strind, | パラ メー タ に 指定 し 、styleName で 指定 し た 名 前 の スタ イル と し て 追加 
StyleOb]ect :Ob]ect) | し ます 。 作成 済み の スタ イル 名 で メソ ッ ド を 呼び 出す と 新しい 値 で 上 書き 
・YO1d で や 半 ます 。 

作成 し た スタ イル を 削除 する に は 、styleObject パ ラメ ー タ を null で 呼び 







ーーーーーーーーーーーーーー ツ ーーーーーーーーーー プ ーー イー ーー 










、 ファ イル (E) 表示 ( 鹿 御 (CO デバ ッ グ (D) 

IFlash で は TestField 内 の 文字 列 に 対し て CSS に よる テキ スト フォ ー マ ッ 
ト を 適用 で きま す 。 

flash text StyleSheet ク ラス の イン スタ ンス を 作成 し て 割 
り 当 て る 方 法 と 、 外 部 の CSS フ ァイル を 読み 込む 方 法 が あり ま 
計 






= 


StyleSheet ク ラス の イン スタ ンス を 作成 し て スタ イル を 割り 当て る 


TextFiel1dSampleH.fF1a 

//8ty1eSheet 上 オブ ジェ クト の 生成 

var style:SEyleSheet = new Sty1eSheet ( ) : 

/ / ス タイ ル 設 定 の た め の オ ブ ジ ェクト 生成 (1 ) 

var gtyle1 :Ob]ect = new Ob]jeoct () : 

Style1 .EFontS1ze = 18: 

gtyle1 .fontWeiqht = "bo1d" : ① 
gt 上 yle1 .Color = "0000FEF": 

Style.SetStyle( ".bo1d Blue size18", sty1e1 ): 


/ / ス タイ ル 設 定 の た め の オ ブ ジ ェクト 生成 (2) の 
var gtyle2:Ob]ect = new Ob]ject ( ) : 





PART 
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5-3 
テキ スト フィ ー ル ド 


8tyl1e2 .FonES1ze = 14: 
8t 上 ye2 . 1etterSpac1nd = 6: 





⑤) 


8tyle2.1eadind = 2: 

8t エ yle2 .Color = 『" 提 FEFO000『":』 

gty1e . setStyl1e( 『.Red spc6 1d2 sg1ze14", gtyle2 ): 
var tf :TextFie1d = new TextFie1d () : 

も WE ね も = 550, 

tf .height = 220: 

tf .mu ユ 1 上 1]1me = 上 UGe: 

tf . wordWrap = TUG: 

tf .styleSheet = 8ty1e: 

tf .htm1Text = "<p clasg='bo1d Blue size18'>Flash で は TextFie1d 内 の 文字 列 に 対 
し て CSS に よる テキ スト フォ ー マ ッ ト を 適用 で きま す 。</p>" + 

"<p class='Red spc6 1d2 size14'>F1ash .text . StyleShee モ エク ラス の イン スタ ンス を 作 


成 し て 割り 当て る 方 法 と 、 外 部 の CS8 フ ァイル を 読み 込 お 方法 が あり ます 。</p>" : --ーーーーーーーーー ベ ゆ 
this . addChi1d (tf ) : 

28 

も まっ = 6: 


で .bold_Blue_size18 と いう 名 前 の クラ ス セ レク タ を 定義 し て いま す 。 2 で 、.Red_ 
spc6_ld2_size14 と いう 名 前 の クラ ス セ レク タ を 定義 し て いま す 。3 で htmlText を 作成 し て 
いま す が 、 そ こ で クラ ス セ レク タ を 使用 し て いま す 。 


ら A へ MPLE ESEC 





も ce ー 


と ーー ーー ーー > チバ w050-… 2 の AKA か SSRe の こ 
Fsh で は TextFekd 内 の 文字 列 に 対し て CS に よる テキ スト フォ ー マ ッ ト を 連用 で きま す 。 fsh text StyleSheet ク 
ラス の イン スタ ンス を 作成 し て 矢 り 当て る 方 法 と 、 外部 の CSS フ ァイル を 読み 込む 方 法 が あり ます 。 





較 CSS ファ イル を 読み 込ん で スタ イル を 邊 定 し た 人 








ビニ ニテ ーー ニー ーー ニテ ーーーーーー- 





OS SS 2 RNN yo KS ーー 記 - ee:、W 


ーーーーーーーーーーーー 
Flash で は TexFjsk 和 AA の 文字 列 こ 対し て CSS に よる テキ スト フォ ー マ ッ ト を 連用 で きま す 。 
flash.text.StyleSheet ク ラス の イン スタ ンス を 作成 し て 割り 当て る 方 法 と 、 
外部 の CSS ファ イル を 読み 込む 方 法 が あり ます 。 


5- さ -8 お 


CSS を 使用 し て テキ スト を フォ ー マ ッ ト す る 


に アン = 問 コ 蘭 m4mm】 コ 蘭 ---- ーーー ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


外部 CSS ファ イル を ロー ド し て スタ イル を 割り 当て る 


p { 一 ーーーーー 
Font-fam11]y: 小 家 ゴ シック Std H, メイ リオ , ゴシック: 
Font-g1ze: 16: 

) 

.headLime { 一 一 ーーーーーーーーーーーーーーーーーーーーー 
Fon-81zZe: 20: 
fon -we1dhe: bo1dq: 

CO1OY: 埋 003366: 


TextFieldSampiel.css 





の 





⑯) 


で は すべ て の <p> タ グ に 適用 する タイ プ セ レク タ を 定義 し て いま す 。② か ら 定 義 し て いる 


.headLine ス タイ ル は クラ ス セ レク タタ です 。 


1mpor 上 fF] .Contro1 g . ButOn : 
Var loader : URLLoader : 
va tf:TextF1ie1d: 


TexfieidSampnlelfla 


var htmlText : St 上 ring = "<span clasg='headLine ' >F1agh</ span> で は 


TextFie1d 内 の 文字 列 に 対し て CSS に よる テキ スト フォ ー マ ッ ト を 適用 で きま す 。" + 


<p>Elagsh .text .StyleShee モ エク ラス の イン スタ ンス を 作成 し て 割り 当て る 方 法 と 、 外 部 の CS8 フ ァイル 


を 読み 込む 方 法 が あり ます 。</p>: 
//TextFie1d オ ブ ジ ェクト を 生成 

tfF = new TextF1ie1d() : 

も f .W1Qdth = 550: 

tf .heiqht = 200: 

tf .multi]imne = ruUG: 

tf .wordWrap = ruGe: 

tf .html1Tex = htm1Text : 

も ER18.aGGCR1 1 上 G( F ), 上 まそ xx = 0: 上 fy ツ = 0: 
/ / 外部 CSS の ロー ド を 開始 する た め の ボ タン を 作成 し て 配置 
Var bn : Buttom = new Bu て on ( ) : 

btn . addEvVentTL1stener (MouseEvent .CLITCK, ]oadCss) : 
btn.1abe] = "CS8 を ロー ド 『: 

this .addChi1d( btn ): 

btn.x = ( gtage .w1dth - btn.width ) / 2: 


trace( btn.xX + リリ + gtage .w1idth + " " 」 btn.width ): 


btn.y = 100: 


| 
| 
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5-3 
デキ スト フィ ー ル ド 


/ / 外 部 C88 フ ァイル を ロー ド 


Function 1oadCss (event : MouseEvent ) :vo1d {1 


( ぬ ) 


Var ur1Req:URLRequest = new URLRequest( "TextFie1dSampleT.Css" ): 
PART 1oader = new URLLoader ( ) : 
1oader . addEvent1Lii st 上 ener (Event .COMPLETE, cssLoadF1nished ): | 
1oader.1oad ( ur1Red ): 
) 
/ /C88 フ ァイル の ロー ド が 終了 し た と き に 呼び 出さ れる 人 ルン ドラ 
function cssLoadFinished (event : Event ) : Yo1d { 一 一 ーーーーーーーーーーーー 
//Sty1eSheet オ ブ ジ ェクト を 生成 し て ロー ド し た CSS8 を 読み 込む 
var gtyle :Sty1leSheet = new StyleSheet () : 





gtyle .parseCS8( 1oader .data ): 
tf . gstyleSheet = 8 上 y16: 

tf .htm1Text = htmlText: 
removeCh11d( btn ): 


この サン プル で は 、 外 部 CSS の 読み 込み に より スタ イル が 動 的 に 適用 され る こと を 確認 する 
た め に 、 ボ タン に よる 読み 込み を 行っ て いま す 。⑬③ で ボタ ン を 作成 し て 配置 し こい ます 。④ で 
外部 CSS フ ァイル を ロー ド し て いま す が 、 ロ ー ド が 完了 し た 時 点 で ⑤ の cssLoadFinished 関 数 
が 呼び 出さ れ 、StyleSheet オ ブ ジ ェクト に ロー ド CSS を 読み 込ん で TextField に 適用 し ます 。 
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ユー ザ 環 境 の フォ ント 情報 を 調べ る 





Flash で ユー ザ が 利用 で きる フォ ント の 情報 を 取得 する に は 、flash.text.Font ク ラス の メ 
ソ ッ ド と プロ バテ ィ を 使用 し ます 。Font ク ラス の enumerateFonts() メ ソ ッ ド に より 、 埋 め 込 
み の み 、 ま た は 埋め 込み と デバ イス フォ ント の リス ト を 作成 で きま す 。 作成 され る リス ト は 
Font オ ブ ジ ェクト の 配列 な の で 、Font ク ラス の プロ パテ ィ で フォ ント 名 な ど を 取得 で きま す 。 


暫 FoOnt ク ラス の 主 な メソ ッ ド 


目的 | メソッド | メソ ッ ド の 概要 上 


現在 の 環境 で 使用 可能 な フォ | enumerateFonts | 現在 の ユー ザ 環境 で SWF が 使用 可能 な フォ ント 
ント を りり スト ドア ッ プ する を 調べ る こと が で きま す 。 


















その フォ ント に 指定 の 文字 | hasG1yph その フォ ント で 文字 ( 列 ) が 表示 可能 か を 調べ る 
が 含ま れ て いる か 判定 する こと が で きま す 。 























和音 FoOnt ク ラス の 主 な ブ プロバ ティ 


目的 | プロ パテ ィ 名 








プロ パテ ィ の 概要 | 
OS: さ | 


埋め 込み 、 ま た は デバ イス の フォ ント 名 を 取得 














フォ ント 名 を 取得 する FontName : 

| Strinqd | し ます 。 
フォ ント が 埋め 込み か デバ | EontType : フォ ント が 埋め 込み か 、 デ バイ ス フ ォ ント か を 
イス フォ ント か を 調べ る ら S 上 て 1nd 調べ る こと が で きま す 。 


FontType.EMBEDDED : 埋め 込み フォ ント 
FontType.DEVICE : デバ イス フォ ント | 
FontType.EMBEDDED _CFF : 埋め 込み の CFF 
フォ ント 























き Font ウ ラス の フォ ント 情報 を 取得 する た め の メ ソ ッ ド 詳細 


メソ ッ ド メソ ッ ド の 詳細 


IUmG エ ra ヒ GF enumerateDev1ceFonEs: | 使用 可能 な フォ ント の リス ト を 配列 で 返し ます 。 
Boo]ean = fa]se) :A エ ray パラ メー タ enumerateDeviceFonts は 次 の よう 
に 使用 で きま す 。 | 
true : デバ イス フォ ント と 埋め 込み フォ ント の 
リス ト を 作成 し ます 。 
false (デフ ォ ル ト ) : 埋め 込み フォ ント の リス 
ト の み を 作成 し ます 。 









































12/ 


PART 
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5-3 
テキ スト フィ ー ル ド 


人 つ 心 M1 F11 F る 
PP Pan ae 
EASY た の 306 ここ ニム ニー 3 






人 P っ さこ / 
4 


中 夫 ゴ シッ ク Pro に device | 
青 ゴシック Po Mt Gevice 
中 替 ゴ ジッ プク Pro 民 device 


下 吉 ゴ シッ プク Sd は device 

目 避 ゴ ジック SMdB deviee 。 
中 王 ゴ シッ ク Siditdevice 。 中 
直志 ゴ シッ ク SNd Ldevice 

直 志 ゴ シッ プク SId Midevice 

小 才 ゴ シッ ク SMdRdeviee 。 


小塚 明 旨 Pro は devwce 
oo ニニ ーー 一 

中 蜂 明 朝 Pro H gevice 

小吉 明 地 ProLdevce 。 


AMPLE ビ ヒロ DE Ei 二 


ユー ザ 環 境 で 使用 で きる フォ ント を 調べ る TextFieldSampleJ.fla 


1mport Flash .Eext .Fon : 
Var の Ob] : Ob]ec : 
Yar て f : TextLEFOrma : 
/ / 埋め 込み 、 デ バイ ス す べ て の フォ ント を 取得 
Var fon gt :Array = Font .enumerateFontg (true ) : ーーーー の ラ ォ ント リス を 取 電 
// フ ォ ン ト 名 の アル ファ ベッ ト 順 で 配列 を ソー ト し ます 
FontTi gt . or 上 On ( "EontName " , Array .CASETNSENSTTTVE) : 
// フ ォ ン トリ スト を 作成 し ます ②List コ ン ポ ー ネ ン ト に フォ ント 名 を 表示 
for ( var ii = 0 : 1 < fontLigt .1ength : 1++ ) 1{ 
ob] = new Ob]ect () : 
ob] . 1abe1 = Font(fontList [1] ) .FontName + ":" + Font(fontLigst [1] ) . 
FontTyDe : 
ob] .data = Font (FontLiigst [1] ) .EontName : 
FontNames 11gst .addaTtem( ob] ): 
) 
FontNamegs 11st .addEventLiistener ( Event .CHANGE, app1yFont ): 
// リ スト が 選択 され た と き の イ ベン トバ ハン ドラ ③ 選 択 さ れ た フォ ント を ダイ ナミ ッ ク テ キス ト に 適用 
Function appl1yFont (event : Event ) :vo1d { 
// 選 択 さ れ た フォ ント を ダイ ナミ ッ ク テ キス ト に 適用 し ます 
var FontName : St 上 rinq = List (event .tarqet ) . selectedTtem . daa: 
tfF = new TextFormat ( FontName ): / 
samp1e xt .setTextFormat( tf ): 「 
FontName xt .Eext = FontName : 
FontName て xt . SetTextFormat( tf ): 


3 -10IME の 有効 無効 を 調べ て オン / オ フ 、 
変換 モー ド を 制御 する 





Flash で IME の 情報 を 取得 し 、 オ ン / オ フ を 制御 する に は 、Capabilities ク ラス と IME ク ラス 
を 使用 し ます 。IME の オン / オ フ は Windows、Mac OSX、Linux そ れ ぞ れ で サポ ー ト され ます 。 
[か な 」、「 全 角 カ ナ 」、「 半 角 カ ナ 」 な どの 変換 モー ド を 示す 定数 は IMEConversionMode ク ラ 





























ス で 提供 され ます 。 
委 Capabiities ク ラス の IME に 関す る プロ パテ ィ 
プロ ティ | メソッド o 
ーー ー ー ーーーー 
現在 の シス テム に IM | hasIME IME が イン スト ー ル され て いる 場合 、 こ の プロ パテ ィ は true に な 
| E が イン スト ー ル され り ま す 。true の 場合 、IME ク ラス を 使用 し て IME の 制御 を 行う こ 
て いる か 調べ る と が で きま す 。 

















暫 IME ク ラス の 主 な プロ バテ ィ 


目的 


プロ パテ ィ 名 








IME 変 換 モ ー ド を 
設定 / 取 得 


IME の オン / オ フ を 


設 征 / 取 得 





SF81OnMode : 
S 上 1nd 


プロ パテ ィ の 概要 


IME 変 換 モ ー ド を 設定 する に は 、 こ の プロ パテ ィ に IME 
ConversionMode ク ラス の 定数 値 を セッ ト し ます 。 こ の 
プロ パテ ィ を 参照 する こと で 、 現 在 の IME 変 換 モー ド を 取 
得 で きま す 。 

















Enabled: Boo1ean 








ーーーーー 





true に する こと で IME を オン 、false で オフ に で きま す 。 








Rm IMEConversionMode クラ ス の IME 変換 モー ド を 表す 定数 































































































変換 モー ド 定数 
全角 英 数 。 | ALPHANUMERIC FULL 

半角 英 数 | ALPHANUMERIC HALF 

全角 か な | JAPANESE HRAGANA 
| 全角 カナ | JAPANESE_KATAKANA_ FULL 
| 半角 カナ | JAPANESE_KATAKANA HALF 
| 中 国語 | CHINESE - 

韓国 語 ] KOREAN 
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5-3 
テキ スト フィ ー ル ド 





* 隊 を 取得 し 、 オ * する に は 
0 







文字 を 還 議 フォ ント コッ シック < サイ スズ 18 を ji ポー ルド 





ーー 


IME モー ド 機 能 つ き 簡 易 エ デイ タ TextFieldSampleKfla 
/ / TME 変 換 モ ー ド を セッ ト す る 関数 


Function setTME (event : Event ) :vo1d 1 


まま 、( っ 吉林 没 も 、 馬 0 間 E ぜ 吉 寺 拉 朝 。 電 寺 人 9 ま 時 ) 4 ーーーーーーーーーーーーーーーーーーー デ ゆ 
Y 対 衣 0 ポ EW、a 生 ウツ 
) el1se { 
TME . enabled = TUG: 
TME . conversionMode = TMEConversionMode [ event .target .value ]: 一 3 
) 
// フォー カス を TextF1ie1d に 移す 
赤 人 お で 義生 凍 の の 家電 も O ま も 


IME の 設定 部 分 の み を 抜粋 し て いま す 。 各 ラ ジオ ボタ ン の value プ ロバ ティ に IMEConversi 
onMode ク ラス の 定数 名 が 設定 され て いま す 。 例 えば 「 全 角 英 数 ] の ラジ オ ボ タ ン の value に は 
"ALPHANUMERIC_FULL" が セッ ト さ れ て いま す 。 そ の 値 を 3③ で 取り 出し て IME 変 換 モ ー ド 
を 変更 し て いま す 。「 オ フ 」 の ラジ オ ボ タ ン に は "OFF "が セッ ト さ れ て いる た め 、 い の 判定 に よ 
り 、⑧ で IME を オフ に し て いま す 。 

④ の fc 変数 は FocusManager ク ラス の イン スタ ンス で 、 フ ォ ー カ ス を テキ スト フィ ー ル ド に 
移し て 編集 し や すく し て いま す 。 





6 - 1 Text Layout Framework (TLF) 





PART Flash Professional CS5 リリ ー ス か ら 、Text Layout Framework (TLF) と いう 新しい ライ 
ブラ リ が 提供 され 、 デ フォ ルト の テキ スト タイ プ と な り ま し た 。 こ の TLF の ベー ス と な る の が 、 
Flash Player に 組み 込み まれ た Flash Text Engine (FTE) で 、Adobe InDesign エ ンジ ン を 流 
用 し た 本 格 的 な テキ スト レイ アウ ト エ ンジ ン で す 。 FTE は flash.text.engine バ ッ ケ ー ジ の API 
と し て 提供 され ます 。FTE は 開発 者 が 独自 に コン ポー ネン ト を 作成 する た め の 基 礎 と な る よう 
に 設計 され て お り 、ActionScript を 駆使 し て 高度 な テキ スト 処理 を 行う コン ポー ネン ト を 作成 
可能 で す 。 し か し 、 非 常に 低 レ ベル な API で ある た め 、 新 し い テ キス ト フ レー ム ワ ー ク こと し て 
TLF が 開発 され て いま す 。TLF は FTE 上 に 構築 され た ActionScript3.0 コ ン ポ ボー ネ ン トラ イブ ラ 

堅 祖 と いう 位置 づけ に な り ま す 。 TLF は 、 リ ッ チ テキ スト レイ アウ ト 機 能 と テキ スト 属性 の 詳細 
な 設定 を サポ ー ト し て お り 、 ク ラシック テキ スト と 呼ば れる よう に な っ た 、 以 前 の テキ スト エ 
ンジ ン よ り も 詳細 で リッ チ な テキ スト 操作 を 行う こと が で きま す 。TLF を ステ ー ジ 上 の テキ ス 
ト フ ィ ー ル ド で 使用 する 場合 、fl.text.TLFTextField ク ラス を 使用 し ます 。TLFTextField は ク 
ラシック テキ スト で ある TextField と 同様 に 、 テ キス ト の 表示 、 編 集 を 提供 する コン ポー ネン 
ト の TLF 版 で す 。 TLF を 使用 する コン テン ツ の パブ リッ シュ に は 、ActionScript3.0 お よび Flash 
Player 10 以 上 が 必要 で す 。 


鐵 Text Layout Framework で 強化 され た 機能 
機能 カテ ゴリ 追加 され た 点 


文字 スタ イル 行 送り 、 合 字 、 人 ハイ ライ トカ ラー、 下 線 、 打 ち 消 し 線 、 大 文字 と 小文字 、 
数 字 ス タイ ル な ど 


段落 スタ イル 余白 の 幅 を 指定 で きる 複数 列 の サポ ー ト 、 最 終 行 の 位置 揃え オプション 、 
イン デン ト 、1 行 目 イ ン デ ント 、 段 落 間隔 、 コ ン テ ナ パ デ ィ ン グ 値 
日 本 語 テ キス ト 属 性 の 制御 | 縦 中 横 、 文 字 組 み 、 禁 則 処 理 タ イプ 、 行 送り モデ ル 


属性 の 適用 ムー ビー クリ ッ プ シン ボル に 配置 し な く て も 、3D 回 転 、 カ ラー 効果 、 ブ 
レン ドモ ー ド な どの 属性 を 適用 可能 


複数 の テキ スト コン テ ナ に わた る テキ スト フロ ー が 可能 


右 - っ 左 方 向 の テキ スト サ | 右 か ら 左 に 表記 され る テキ スト に 、 左 か ら 右 に 表記 され る テキ スト の エ 
ポー ト レ メ ン ト を 含め る こと が 可能 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 
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りー す ー1 
FTE と TLF 


乱 TLFTextField クラ ス の 主 な プロ パテ ィ 


アン チエ イリ アス 処 | antiA1iasType この テキ スト フィ ー ル ド に 使用 され る アン チエ イリ 
理 の タイ プ を 設定 す | :String アス 処理 の タイ プ を 表し ます 。 

る flash.text.AntiAliasType.NORMAL : 通常 の テキ 
スト に アン チエ イリ アス を 適用 し ます 。 
flash.text.AntiAliasType.ADVANCED : 文字 を 読 
みや すく する 高度 な アン チエ イリ アス を 適用 し ます 。 


テキ スト フィ ー ル ド の 自動 的 な 拡大 / 縮 小 お よび 整 
列 を 制御 し ます 。 

TextFieldAutoSize.NONE (デフ ォ ル ト ) : サイ ズ 
変更 は 行わ れ ま せん 。 
TextFieldAutoSize.LEFT : 左 揃え 
TextFieldAutoSize.RIGHT : 右 揃え 
TextFieldAutoSize.CENTER : 中 央 揃え 


テキ スト フィ ー ル ド に 背景 の 塗り つぶ し が ある か ど 
うか を 指定 し ます 。 

true : 育 景 の 塗り つぶ し が あり ます 。 

false (デフ ォ ル ト ) : 背景 の 塗り は あり ませ ん 。 


育 景 の アル ファ 値 を | backgroundA1pha テキ スト フィ ー ル ド の 背景 の アル ファ 値 を 指定 し ま 

指定 する : NumDer す 。 デ フォ ルト 値 : 1.0 

育 景 の 色 を 指定 する | backqroundCo1or テキ スト フィ ー ル ド の 背景 の 色 を 指定 し ます 。 
:u1n デフ ォ ル ト 値 : OxFFFFFF ( 白 ) 


垂直 / 水 平方 向 の 行 | b1ockProgression 垂直 方 向 ま た は 水平 方 向 の 行 配置 を 指定 し ます 。 
配置 を 指定 する flashx.textLayout.formats.BlockProgression. 
TB : 上 か ら 下 ( 横 書 ) 
flashx.textLayout.formats.BlockProgression. 
RL : 右 か ら 左 (日 本 語 や 中 国語 な どの 縦 書 ) 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 
デフ ォ ル ト 値 : undefined 


テキ スト フィ ー ル ド に 境界 線 が ある か どう か を 指定 
し ます 。 

true : 境界 線 が あり ます 。 

false (デフ ォ ル ト ) : 境界 線 は あり ませ ん 。 


境界 線 の アル ファ 値 | borderA1pha 境界 線 の アル ファ 値 を 指定 し ます 。 

を 指定 する : NumDer デフ ォ ル ト 値 : 1.0 

境界 線 の 色 を 指定 す | borderCo1or : uint テキ スト フィ ー ル ド の 境界 線 の 色 を 指定 し ます 。 

る デフ ォ ル ト 値 : 0x000000 ( 黒 ) 

境界 線 の 太 さ を 指定 | borderWidth 境界 線 の 太 さ を 1 ~ 100 の 範囲 で 指定 し ます 。 

する : NumDer デフ ォ ル ト 値 : 1 

カー ソル 位置 の イン | caretTndex : int [読み 取り 専用 ] カー ソル (キャ レッ ト ) 位置 の イン 
デック ス を 取得 する 


































デキ スト フィ ー ル ド 
の 自動 拡大 / 縮 小 と 
整列 を 設定 する 


autOS1 ze : S 上 1n 可 
















育 景 塗り つぶ し が あ | backqround 
る か を 指定 する : Boo1ean 






























境界 線 が ある か を 指 | borqer : Boo1ean 

















デック ス を 表し ます 。 フ ォ ー カ ス が な い 場 合 、 0 で す 。 
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6- 1 
Text Layout Framework (TLF) 


怠 TLFTextField クラ ス の 主 な プロ パテ ィ ( 続 き ) 


テキ スト 列 の 数 を 指 テキ スト 列 の 数 を 1 て 50 の 整数 で 指定 し ます 。 数 値 
定 す る を 指定 し な いで 次 の 値 を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.AUT 
O : 自動 的 に 決定 し ます 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


列 間 の ふち 取り 領域 を 0 て 1000 の ピク セル 単位 で 指 
定 し ます 。 数 値 を 指定 し な いで 次 の 値 を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


列 幅 を 0 て 8000 の ピク セル 単位 で 指定 し ます 。 数 
値 を 指定 し な いで 次 の 値 を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.AUT 
O : 自動 的 に 決定 し ます 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


HTML テ キス ト また は TLF マ ー ク アッ プ が 含ま れる 
テキ スト フィ ー ル ド 内 の 余分 な 空白 (スペ ー ス 、 改 
行 な ど ) を 削除 する か どう か を 指定 し ます 。 

true : 空白 文字 を 削除 し ます 。 

false (デフ ォ ル ト 値 ) : 空白 文字 を 削除 し ませ ん 。 


新しく 挿入 する テキ スト (ユー ザ が 入力 し た テキ ス 
ト や replaceSelectedText() メ ソ ッ ド で 挿入 し た テ 
キス ト な ど ) に 適用 する フォ ー マ ッ ト を TextFormat 
オブ ジェ クト で 指定 し ます 。 


テキ スト ブロ ッ ク 内 に ある テキ スト の デフ ォ ル ト の 
双方 向 埋め 込み レベ ル を 指定 し ます 。 
flashx.textLayout.formats.Direction.LTR : 

左 か ら 右 へ の 向き を 指定 し ます 。 
flashx.textLayout.formats.Direction.RTL 

右 か ら 左 へ の 向き を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


パス ワー ド 入 力 用 か を 指定 し ます 。 

true : 入力 文字 は アス タリ スク 表示 され ます 。 
false (デフ ォ ル ト 値 ) : 入力 文字 は その まま 表示 さ 
れれ ます 。 


埋め 込み フォ ント の アウ トラ イン を 使用 し て レン ダ 
リン グ す る か を 指定 し ます 。 

true : 埋め 込み フォ ント の アウ トラ イン を 使用 し ます 。 
false (デフ ォ ル ト 値 ) : 埋め 込み フォ ント の アウ ト 
ライ ン を 使用 し ませ ん 。 



























CO」umrmCOun 
: Ob] ec 上 













列 間 の ふち 取り 領域 
キャ ッ プ を 指定 する 


CO1ummGaDp 
:Ob] ec 
















ColumnW1dth 
:Ob] ec 上 





列 幅 を 指定 する 



















Conden8eWh ュ te 
: Boolean 


テキ スト フィ ー ル ド 
内 の 空白 (スペ ー ス 、 
改行 な ど ) を 削除 す 
る 

























defau] 上 Tex ヒ 
Format :Flash . 上 ext : 
TG メ ヒド FO エ ma ヒ 


新しく 挿入 する テキ 
スト の フォ ー マ ッ ト 
を 指定 する 













左右 方 向 の 読み 順 を 
設定 する 


direC 七 1on : S 上 1md 

























パス ワー ド 入 力 用 に 
する 


d1iSplayASPa88 
woOrQd : BOO1ean 








embedFont8 
: Boolean 


埋め 込み フォ ント の 
アウ トラ イン を 使用 
する か を 指定 する 


















6-1-1 
FTE と TLF 


圭 TLFTextField クラ ス の 主 な プロ パテ ィ ( 続 き ) 


最初 の 行 の ベー スラ | firstBase1 ine コン テ ナ 内 の 最初 の 行 の ベー スラ イン 位置 を 0 て 
イン 位置 を 指定 する | OEEset :Ob]ject 1000 の 数 値 で 指定 し ます 。 下 記 の 定数 も 使用 で き 
ます 。 
flashx.textLayout.formats.BaselineOffset. 
AUTO : 行 の アセ ント と コン テ ナ の 上 部 の イン セ 
ッ ト を 揃え ます 。 
flashx.textLayout.formats.BaselineOffset.AS 
CENT : 行 の アセ ント と 等 し い オ フ セ ッ ト を 指定 し 
ます 。 
flashx.textLayout.formats.BaselineOffset. 
LINE_HEIGHT : 行 の 高 さ と 等 し い オ フ セ ッ ト を 指 
定 し ます 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


この テキ スト フィ ー ル ド に 使用 され る グリ ッ ド フィ 
ッッ ディ ング の タダ イプ で す 。 
flash.text.GridFitType.NONE : グリ ッ ド フィ ッ 
ティ ング な し を 指定 し ます 。 
flash.text.GridFitType.PIXEL : 太い 水平 線 と 垂直 
線 が ピク セル グリ ッ ド に 合わ さる よう に 指定 し ま 
ずら 

flash.text.GridFitType.SUBPIXEL : 太い 水平 線 と 
垂直 線 が 、LCD モ ニタ ー の サブ ピク セル ゲ グリッド 
に 合わ さる よう 指定 し ます 。 


テキ スト フィ ー ル ド の 内 容 を HTML で 表し ます 。 
次 の 基本 的 な HTML タ グ と <textforma セ タグ が サ 
ポー ト さ れ ま す 。 

<a> <D> <br> <font> <img> <i> <D> <SDan> <U> 
Part5 攻 衣 可 本 の 「HTML テ キス ト を 表示 する 」 を ご 
覧 くだ さい 。 そ ちら で 解説 し て いる クラ シッ ク 
TextFieid ク ラス と 異な る の は 、TLFTextField ク ラ 
ス で は 、 リ スト タグ を サポ ー ト し な いこ と で す 。 


文字 数 を 取得 する 1Tength : 1n [読み 取り 専用 ] タブ な どの 文字 も 含め た テキ スト 
フィ ー ル ド 内 の 文字 数 を 表し ます 。 


入力 で きる 最大 の 文 | maxChars : int ユー ザ が 入力 で きる 最大 の 文字 数 を 表し ます 。 プ ロ 
字数 を 指定 する グラ ム に よる 入力 に は 適用 され ませ ん 。 
デフ ォ ル ト 値 : 0 (制限 な し を 表し ます ) 


マウ スホイ ー ル に よ | mouseWhee1 ユー ザ が テキ スト フィ ー ル ド を クリ ッ ク し て ホイ ー 
る スク ロー ル を 有効 | Enabl1ed:Boo1ean ル を 回 転 さ せる と 、 自 動 的 に スク ロー ル す る か どう 
/ 無 効 に する か を 示す ブー ル 値 で す 。 

デフ ォ ル ト 値 : true (スク ロー ル し ます ) 


































グリ ッ ド フィ ッ テ ィ | gridFitType 
ング の タイ プ を 指定 
する 
















内 容 を HTML で 表す | htm1Text : String 














復 数 行か を 指定 する | mu1ti1ine:Boo1lean | テキ スト フィ ー ル ド が 複数 行 テ キス ト フ ィ ー ル ド で 
ある か どう か を 示し ます 。 
デフ ォ ル ト 値 : false ( 単 一 行 ) 


テキ スト 行 の 数 。 | numLines:int [読み 取り 専用 ] 複数 行 テ キス ト フ ィ ー ル ド 内 の テ 
キス ト 行 の 数 を 取得 で きま す 。 
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6- 1 
Text Layout Framework (TLF) 


征 TLFTextField クラ ス の 主 な プロ パテ ィ ( 続 き ) 


コッ デ ナ オナ と チオ キズ スネ コン テ ナ 下 部 の 上 上 端 / 下 端 / 左 端 / 右 端 と テキ スト の 



















paddinqdTOp 



















の 間 の スペ ー ス を 指 | :Op]ject 間 の スペ ー ス を 0 て 1000 の ピク セル 値 で 指定 し ます 。 
定 す る padd1nmgBot て Om 数 値 ま た は 次 の 値 を 指定 で きま す 。 
: Ob] ec 上 flashx.textLayout.formats.FormatValue.INHE 
paddingLeft RIT : 親 の 値 を 継承 し ます 
: Ob] ec も 
padd1nqR1dht 
: Ob] ec 























ユー ザ が テキ スト フィ ー ル ド に 入力 で きる 文字 の 
セッ ト を 指定 で きま す 。"A-Z" の よう に ハイ フン で 
範囲 を 指定 で きま す 。 この 場合 、AーZ の 文字 の み 入 
力 可能 に な り ま す 。 

デフ ォ ル ト 値 : null (制限 な し ) 


現在 の 水平 スク ロー ル 位 置 ( ビ クセ ル 数 ) / 垂 直 ス 
クロ ー ル 位置 ( 行 数 ) を 表し ます 。 値 を 設定 する こ 
と で テキ スト を 指定 の 位置 まで スク ロー ル さ せる こ 
と が で きま す 。 


テキ スト フィ ー ル ド が 選択 可能 で ある か どう か を 表 
し ます 。 
デフ ォ ル ト 値 : true (選択 可能 ) 


[読み 取り 専用 ] 現在 の 選択 範囲 の 最初 / 最 後 の 文 字 
を 示す イン デック ス 値 で す 。 先 頭 文 字 の イン デック 


ユー ザ が 入力 で きる 
文字 を 制限 する 


eS8 キ 了 1C : 8S 上 1md 












CO1 1 日 : 1n ヒ 上 
C 了 Oo1 1 V : ュ m ヒ 


水平 / 垂 直 ス クロ ー 
ル 位 置 を 取得 / 設 定 
する 



















ge]ectab1e 
: Boolean 






テキ スト が 選択 可能 
か を 指定 する 


















select ionBed1n 
Tndex : 1nt 


選択 範囲 の 最初 / 最 
後 の イ ン デ ックス を 







取得 する ge]ectionEnd ス は 0 で す 。 

Tndex : 1n キ デフ ォ ル ト 値 は : 0x000000 (上 黒 ) 
テキ スト を 取得 / 設 | Lext : String テキ スト フィ ー ル ド 内 の 現在 の プレ ー ン テキ スト を 
定 する 表し ます 。 
テキ スト の 色 を 取得 | LextCo1or : uint テキ スト フィ ー ル ド の テキ スト の 色 を 16 進 数 形式 
/ 設 定 する で 表し ます 。 













TLF ク ラス に よる 書式 を TLFTextField フ ィ ー ル ドイ 
ンス タン ス に 割り 当て る こと が で きま す 。 


TLF ク ラス に よる 書 | LextF1ow:Elashx . 
式 を 設定 する た め の | textLayout . 

TextFlow オ ブ ジ ェ | el1ements : TextF1ow 
クト を 取得 / 設 定 す 
る 


テキ スト の 高 さ / 幅 




















textHe1qh [読み 取り 専用 テキ スト の 高 さ / 幅 を ピク セル 単位 











を 取得 する : NumDe エ で 取得 で きま す 。 
textW1Qdth 
: NumDer 
TLF マ ー ク アッ プ を | t1fEMarkup : St 上 r1ndg テキ スト の TLM マ ー ク アッ プ を 設定 また は 取得 し 
取得 / 設 定 する ます 。 
テキ スト フィ ー ル ド | type : Stringd テキ スト フィ ー ル ド の タイ プ を 表し ます 。 
の タイ プ を 取得 / 設 TextFieldType.DYNAMIC( デ フォ ルト 値 ) : 選択 
定 する 可能 で す が 、 編 集 す る こと は で きま せん 。 
TextFieldType.INPUT : 編集 可能 な TLF テ キス ト フ 
イィ イール ド 。 





あー リー タ 
FTE と TLF 


矯 TLFTextField クラ ス の 主 な プロ バテ ィ ( 続 き ) 


コピ ー 時 に フォ ー | useRichTextC11p テキ スト と 一 緒 に テキ スト の tffMarkub フ ォ ー マ ッ 
マッ ト も 含め る か を | board : Boo1ean ト も クリ ッ プ ボー ド に コピ ー す る か どう か を 指定 し 
取得 / 設 定 する ます 。 

デフ ォ ル ト 値 : false (コピ ー し な い ) 


垂直 方 向 の 行 揃え また は 均等 配置 を 表し ます 。 
flashx.textLayout.formats.VerticalAlign.TOP : 
フレ ー ム の 上 端 に 揃え ます 。 
flashx.textLayout.formats.VerticalAlign.MID 
DLE : フレ ー ム の 中 央 に 揃え ます 。 
flashx.textLayout.formats.VerticalAlign.BOT 
TOM : フレ ー ム の 下端 に 揃え ます 。 
flashx.textLayout.formats.VerticalAlign.JUST 
IFY : フレ ー ム 内 で の 垂直 方 向 の 行 の 均等 配置 を 指 
定 し ます 。 
flashx.textLayout.formats.FormatValue.INHE 
RIT : 親 の 値 を 継承 し ます 。 


テキ スト フィ ー ル ド の テキ スト を 折り 返す か 否 か を 
表し ます 。 
デフ ォ ル ト 値 : false (折り 返さ な い ) 







































垂直 方 向 の 行 揃え ま | vertica1A11ign 
た は 均等 配置 を 取得 
/ 設 定 する 



























テキ スト を 折り 返す | wordWrap 
か 否 か を 取得 / 設 定 | :Boo1ean 
する 








名 TLFTextField クラ ス の 主 な メソ ッ ド 


テキ スト を 追加 する | appendText (newText : newText で 指定 され た スト リン グ を テキ スト 
String) :vo1d フィ ー ル ド 内 テキ スト の 未 尾 に 追加 し ます 。 
+ 演 算 子 に よる 追加 より も 高速 に 行い ます 。 


現在 の 選択 文字 列 を | replaceSelectedText ( | 現在 の 選択 文字 列 を value の 内 容 に 置き 換え ます 。 
置き 換え る value : String) :void 


男 囲 を 指定 し て 文字 | rep1laceText ( 開始 位置 と 終了 位置 を 指定 し て 文字 列 を 置き 換 
列 を 置き 換え る beginTndex : 1nt , えま す 。 

endTndex : in , beginIndex : 開始 位置 

newTex : St 上 rind) : endIndex : 終了 位置 

vo1d newText : この 文字 列 に 置き 換え ます 


開始 位置 と 終了 位置 を 指定 し て 文字 列 を 選択 し 
ます 。 

beginIndex : 開始 位置 

endIndex : 終了 位置 











































範囲 を 指定 し て 文字 
列 を 選択 する 


SetLSelection ( 
begTdx : 1nt , 
endTQx : 1nE ) : ゞ Oo1d 





算 TLFTextField クラ ス の 主 な イベ ント 


値 が 変更 され た Chande コン トロ ー ル の 値 が 変更 され た 後に 送出 され ます 。 
(定数 Event.CHANGE) ユー ザ が テキ スト フィ ー ル ド に テキ スト を 入力 する 
と 、 キ ー ス トロ ー ク の た びに change イ ベン ト が 送 
出さ れ ま す 。 
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6- 1 


Text Layout Framework (TLF) 


待 TLFTextField クラ ス の 主 な イベ ント (続き ) 






八 イ パー リン ク を ユ 
ー ザ が クリ ッ ク 





スク ロー ル さ れ た 










] 1nk 


(定数 TextEventLINK) 


紀 CO 〇 1 ユ 






(定数 Event.SCROLL) 






れ ま す 。 






ユー ザ が テキ スト の 
文字 を 入力 し た 


| | | 笑 語 が 得 音 な 詞 は 、 そ の まま 読ん で くだ 
有 ・ も 4 日 本 語 に 訳す と 、 次 の よう に な り 


| レト ビ 合 う ランタ イム (AIR) は 、 
| | 特 板 1 ウロ ス オ ペ レー ティ ング シス テム 






EeGx 上 TnmDUu 巧 


( 定 数 TextEvent._TEXT_ 


INPUT) 


IR アプ リケーション の ブ ァ イル 記 式 


AIR アプ リケーション の 本 体 は 、Flash と 


同じ SWF 形式 で す 。 そ の た め 、 実 行 に 
は FlshPlsyer が 必要 と な り ま す 。 し か 
し 、AIR アプ リケーション せ は Flssh コン 
テン ツ の よ うに ブラ ウザ で 実行 され る の 
で は な く 、OS に イン スト ー ル され た ア 
プリ ケー ショ ン と し て 動作 し ます 。 


で せ は FlshPlayer は どこ で 働く か と いう 
と 、「 ラ ンタ イム 」 と いう の アブ プリ 
ケー ショ ン 肉 に 組み 込ま れ た 大 で 動作 し 
ます 。 次 に ラン タイ ム を は じ め と する 基 
本 用 語 に つい て ござ ご 紹介 し ます 。 


1.13。 ラン タイ ム と は ? 一 基本 用 語 を 
理解 する 


ラン タダ イム と は 
ラン タイ ム は 日 本 語 で は 「 実 行 環境 」 
と 訳し 、 ア ブリ ケー ショ ン 本 体 を 


稼動 さ 
せる た め に 必要 な ブロ ダグ ラム を 意味 し ま 
FlshPlyer が 組 


AIR アプ リケーション を イン スト ー ル し 
て 実行 する 前 に セッ ト ア ッ プ し て お く 多 
要 が あり ます 。A ム dobe サイ ト か ら 電 偵 で 
ダウ ン ロ ー ド で きま す 。 


2 ・ オ ペレ ー テ ィング ・ シ ステ ム と 


馬 ス と ・ オ ペレ ー テ ィング ・ シ ステ ム 
、「 同 じ ア ブリ ケー ショ ン が 時 な る OS 
で 二 作 する 」 こと を 意味 し ます 。 ーー 
ブリ ケー ショ ン は 「 Wimdows 苗 」「IMe 












標準 キー ボー ド 、 





生 の よう な OS 別 の 只 な る パー: ジョ ン 
を 作る 必要 が な く 、 っ た そ 
の まま 暴 な る OS 上 で 動作 し ます 。 


ラン タイ ム の 役割 

AIR ラン タイ ム (mntme) と は 、AIR アブ 
リケーション が 実行 する た め の 環 境 を 提 
供する プロ グラ ム で す 。 こ の 「 ラ ンタ イ 
ム 」 が AIR を 理 醍 する た め の キ ー ワ リー ド 
に な り ま す 。 


AIR の 料 攻 1. に 「 ケ ロス オペ レー ティ ン 
ダグ システム の ラン タイ ム 」 と いう こと が 
あり ます が 、「 ラ ンタ イム 」 は AIR アブ 
リケーション を 実行 する た め の 土 台 と し 
て 働く ブロ グ う ラム で す 。 


つま り 、AIR アプ リケーション は ラン タ 
イィ ム と いう 補助 的 な プロ グラ ム の 助け を 
借り て 動作 し ます 。 突 際 に は 、 ラ ンタ イ 
ム は AIR アプ リケーション を イィ インストー 
ル す る た め の 環 境 を 提供 し 、 次 の 図 の よ 
うに 、 天 本 時 に は OS と AIR アブ リ ケ ー 
ショ ン の 間 で 働き ます 。 


AIR ラン タイ ム の イメ ー ジ 


ケロ ス OS を 実現 する 仕組 み 

な ぜ こ の よ うな 2 重 橋 成 に な っ た か を 理 
棲 す る た め に 、「 ク ビス オ ペレ ー テ ィ ン 
ダグ シス テム 」 (以下 クロ ス OS と 呼び ま 
す ) を 実現 する た め の 働 組み を 考え ま 
す 。 こ れ は 「 同 じ ア プリ ケー ショ ン が そ 
の まま 複 雪 て これ を 「 ケ ロス 」 と 呼び ま 
す ) の オペ レー ティ ング シス テム で 動作 





HTML が 有効 に な っ て いる テキ スト フィ ー ル ド の ハ 
イ パ ー リ ンク を ユー ザ が クリ ッ ク し た と き に 送出 さ 





ユー ザ が スク ロー ル し た 後に 、TextField オ ブ ジ ェ ク 
ト に よっ て 送出 され ます 。 


IME、 音 声 認 識 シ ステ ム 、 書 式 や ス 
タイ ル の 情報 を 持た な い プ レー ン テ キ スト の ペー スト 
操作 な ど に よっ て 、 こ の イベ ント が 送出 され ます 。 


紀 AMPLE ヒロ DE 還 滞 EEEEEEEEEEEEEEEE55E5555EEE55535 二 


TLFTextField を 使 つ ※ 実 行 に は FlashCS5 が 必要 TLFTextFieldSample.fla 
① 





Funotion 1n1i キ () :Vo1d 
[ 
/ /TLFTextFie1d の プロ パテ ィ 設 定 
ed1tor xt .mul ヒ 上 111me = rUuG: 
ed1tor xxt .WOrdWraD = ruG: 
// デ フォ ルト の コラ ム 数 、 ギ ャ ッ プ 、 幅 を 設定 
editor txt .Co1umnCount = 2: 





② 
TLF Co1ummCountNumer1cStepper .Yalue = 2: 


も - す サー: 


FTE と TLF 
ot て oe 
TLF Co1umnGapNumer1CSteDDer .Value = 1: 
ed1itor xt .Co]ummW1dth = 200: 

TLF Co1umnW1dthNumer1CS も epper .Value = 200z: 一 一 ーーーーーーーーー デ ーーー④ 
// イ ベン トリ スナ ー 
TLF Col1umnCountNumer1CStepper . addEventLi1 st 上 ener ( Event . CHANGE , 
setT1FColumnFormat ): 
TLF Col]umnGapNumer1CStepper . addEventL1stener ( Event .CHANGE , 
getT1FCo]1umnEFormat ): 
TLF ColumnW1QthNumer1CStepDper . adQdEVentLi1 stener ( Event . CHANGE , 
8etT1ECo1umnFormat ): 
) 
/ /TLF に よる コラ ム 制 御 : 
Function setT1FCo1umnFormat (event : EVen ) : Vo1d 
( 
8Sw1tch ( eVvenrt .tarqdet .name ) 
( 
ca8e "TLE ColummnCountNumer1CSeDDer" 
editor て xt .Co1umnCounE = evert .tarqget .Yalue : 一 一 一 ーーーーーーーー ぺぺ ょ 
DreaK : 
Case "TLEF Col1umnGapNumer1CSteDpDper『" 
ed1tOr 上 xt .CO1umnGaDp = eVentt .tarde . Value@ : 一 一 ーーーーーーーー ⑥ 
break : 
Ca8e "TLEF ColumrnW1dthNumer1CSteDpDer" 
ed1tor xt .CO1umrnW1dEDb = event .tarqet .Ya1ue : 一 ーーーーーーーーーー の ⑦ 


DreaKk : 


1ni ( ) : 


この サン プル で は クラ シッ ク TextField に は な い 列 情報 の 変化 に よる テキ スト フロ ー の 制御 
を 確認 し ます 。 か ら の init() 関 数 で TLFTextField の コラ ム に 関す る 初期 値 を 設定 し て 、Num 
ericStepper の イベ ント リス ナー を 登録 し て いま す 。⑧ と ⑤ で 行っ て いる よう に コラ ム 数 は 
ColumnCount、3③ と ⑥⑤ の よう に コラ ムギ ャ ッ プ は columnGap、④ と ⑦ の の よう に コラ ム 幅 は 
columnWidth プ ロバ ティ に より 設定 を 行い ます 。 
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2 レル を を 4 





TLF の テキ ス ト デ ー タ 構造 は 、TextFlow オ ブ ジ ェクト を ルー ト と する flashx.textLayout. 
elements パ ッ ケ ー ジ クラ ス の 階層 構造 で 定義 ご され ます 。TextFlow オ ブ ジ ェクト へ の テキ スト 
デー タ の 読み 込み に 関し て は 、 プ レー ン テ キ スト と HTML テ キス ト 以 外 に 、 XML ベー ス の マー 
クア ッ プ 言語 を 使用 し て 効率 的 に 定義 で きま す 。 そ の 言語 は TLF マ ー ク アッ プ 言 語 と 呼ば れ 、 
下 表 「TLF マ ー ク アッ プ 言 語 の エレ メン ト と クラ ス の 対応 ] に ある エレ メン ト を 使用 可能 で す 。 
TLF マ ー ク アッ プ に よる デー タ は スト リン グ 、XML い ずれ で も 作成 し て 読み 込む こと が で きま 
す 。 マ ー ク アッ プ で 作成 し た テキ スト を 読み 込む 場合 、TextConverter ク ラス の import 
ToFlow() メ ソ ッ ド に より 、TextFlow オ ブ ジ ェクト と し て 取得 する こと が で きま す 。Text 
Converter ク ラス は 、TLF で この よう な イン ボー ト 変 換 や エク スポ ボート を 行う た め の ク ラス と 
し て 用 意 さ ご され て いま す 。 一 方 、TextFlow オ ブ ジ ェクト を 表示 する 場合 、 テ キス ト を 表示 する 
た め の 表 示 オ ブ ジ ェクト コン テ ナ を 管理 する (表示 コン トロ ー ラ ) IContainerController イ ン 
ター フェ イス と 、 テ キス ト の 実際 の 表示 レイ アウ ト を 管理 する IFlowComposer イ ンタ ー フ ェ 
イス が 使用 され ます 。 こ れ ら の 実装 ラス と し て 、ContainerController ク ラス と 、Standar 
dFlowComposer ク ラス が あり ます 。 使用 方 法 は 、 本 項目 の サン プル コー ド 解 説 を ご 覧 に な っ 
て くだ さい 


一 TLF マ ー "ジア ッ プ 言語 に よる テキ スズ トト 構造 例 





textflOow 


ンー ンプ て 、。 > 


SDan 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー つ 


徒 TLF マ ー ク アッ プ 言 語 の エレ メン ト と クラ ス の 対応 





























] こつ ・ ド | 人 な 子 エレ メン ト 
textfiow TextFlow ルー ト エ エレメント で す 。 diV、D 
div DivElement | 段落 を グル ー プ 化し ます 。 - | D 
| D | ParagraphElement | 段落 を 表し ます 。 任意 の エレ メン ト を 含 | a、tcy、SDan、im9、 
め る こと が で きま す 。 | tab、br 














6-1-2 
TLF マー クア ッ プ 言語 を 使う 


符 TLF マー クア ッ プ 言語 の エレ メン ト と クラ ス の 対応 (続き ) 


LinkElement 






使用 可能 な 子 エ レ メ ン ト 


リン ク を 表し ます 。 tcy、Span、im9、 
tab、bDr 


TCYElement 縦 書き の 行 の 中 で 横書き の テキ スト 範囲 | a、span、img、tab、 


を 定義 し ます 。 
SpanElement フォ ー マ ッ ト 属 性 セッ ト を 持つ 段落 内 の 
Imd InlineGraphic 
Element 


テキ スト 範囲 で す 。 
TabElement 
の 










に 


グ ゲ グラフィック オプ ジェ クト (イメ ー ジ ) で す 。 
t タブ 文字 <tab/> を 表し ます 。 
b BreakElement ブレ ー ク 文字 で す 。 新 し い 段 落 を 作成 し 
な いで 改行 を 作成 し ます 。 


linkNormal | TextLayoutFormat | 通常 の 状態 の リン ク に 使用 され る フォ ー 
Format マッ ト 属 性 を 定義 し ます 。 


リン ク 上 で マウ ス ボ タ ン が 押さ れ た と き 
に 、 ア クティ ブ 状 態 の リン ク に 対し て 使 
用 され る フォ ー マ ッ ト 属 性 を 定義 し ます 。 


マウ ス が リン ク の 境界 内 に 移動 され た と 
き に 、 ホ バー 状態 の リン ク に 対し て 使用 
され る フォ ー マ ッ ト 属 性 を 定義 し ます 。 


















linkActive 
Format 


TextLayoutFormat 












linkHover 
Format 


TextLayoutFormat 









征 TextConverter ク ラス の 主 な メソ ッ ド 


メソ ッ ド の 概要 


[ 静 的 ] source で 与え られ る TextFlow オ ブ ジ ェ 
クト を 指定 され た 形式 (FXG、HTML、 プ レー 
ン テ キ スト 、 TLF マ ー ク アッ プ ) に エク スポ ボー 
ト し ます 。 

format : 
TextConverter.TEXT_FIELD_HTML_FOR 
MAT : 

プレ ー ン テキ スト 形式 で エク スポ ー ト し ます 。 
TextConverter.PLAIN_ TEXT_FORMAT : 
HTML 形 式 で エク スポ ー ト し ます 。 
TextConverter.TEXT_LAYOUT_FORMAT : 
TextLayout 形 式 で エク スポ ー ト し ます 。 
CoOnVersionTVDe : 
ConversionType.STRING_TYPE 
ConversionType.XML_TYPE 


























TextFlow を エク ス 
ポー ト す る 


eXDOr ( 
SOurCe :fla8Shx . 
textLayOu 上 t . GL1emen8 : 
TextF1OwW , 
Forma : S 上 了 ュ nd , 
ConVyera1onTyDe : S 上 rinq 
) : Ob]ect 
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6- 1 
Text Layout Framework (TLF) 


符 TextConverter ク ラス の 主 な メソ ッ ド (続き ) 


1mportToF1ow ( 
8OurC@ : Ob] ec , 
FOrma : S 上 1mnd , 
Conf ュ 1qd : TConf 1qduration 
= TUH1 

): 上 Flashx .textTLayoOut . 
elementg : TextF1Oow 


メソ ゾ ッ ド の 概要 


[ 静 的 ] format で 指定 され た 形式 で 、source で 
与え られ る ソー ス か ら TextFlow を 作成 し ます 。 
format : 
TextConverter.TEXT_FIELD_ HTML FOR 
MAT : プレ ー ン テキ スト 形式 で イン ポー ト し ま 
の 

TextConverter.PLAIN TEXT FORMAT : 
HTML 形 式 で イン ボ ポート し ます 。 
TextConverter.TEXT_LAYOUT FORMAT : 
TextLayout 形 式 で イン ポー ト し ます 。 



































TextFlow に イン ポ ボ 
ー ト する 















ンス テム 開発 者 や 、 プ ログ ラミ ング まで 行う 一 部 の 高度 な パソ コン ユー ザ で し か 作る こと が 難し か っ た デス 
クト ッ プ アプ リケーション が 簡単 に 作れ る 時 代 に な り ま し た 。 

し か も その アプ リケーション は 動画 アニ メー ショ ン や ビデ オ の 再生 を 行い 、 イ ンタ ーネット に アク セス し 、 
』 組み 込ま れ た デー タベース エン ジン を 使用 し て 半 大 な デー タ を 高速 に 処理 する こと が で きま す 

P 

| Adobs AAR (Adobe Integrated Runtims ア ド ビ エ アー) は 、 個 人 の 怒 味 や 実 還 を 目的 と し た アプ リケーション だ け で な く 、 業 ! 
や レベ レル に 填 公 耐 え う る 開 閉 と 信二 性 を 併せ 持つ アプ リケーション を 作成 する た め の 環 寺 と 開発 方 法 を 提 供する イン フラ で 







= お 前 器 肖 才 可 m】 コ 敵 つつ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


TLF マー クア ッ プ に よる TextFlow オブ ジェ クト の 作成 と 表示 
※ 実 行 に は FlashCS5 が 必要 TLFMarkupSample.fla 


1mport FE]ash .disp1ay . Sprite: 

1mport F]ashx .textLayout . e]ements . TextF1]ow: 

1mpor モ F1ashx .textTLiayout . Eormats . TextTLiayoutFormat : 
1mpor F]ashx .textTLiayout . container .ContainerContro1 1 er : 
1mpor F]ashx .textLayout . Compogse . StandardF1owComposer : 


1mpor Fl]ashx .textTiayout . Convergion . TextConver ヒ er : 


6ー ョ キー メ 
TLF マー クア ッ プ 言語 を 使う 


var fF]owData : TextF1Ow: 


var fF1owFormat : TexELiayOut 上 FoOrma 』 


/ / 表 示 コ ン テ ナ オプ ジェ クト と サイ ズ 
Yar texCon キ a1mer : SD エ ユ 6 : 
var ContainerHe1qght :NumDer = 500: 


yar containerW1dth :Number = 780: 


/ /TLE マ ー ク アッ プ に よる テキ スト デー タ 一 ーーーーーーーーーーーーーーーーー デ ーーーーーーーーーー の 
Var 上 1EMarKUuD : XML = 
<TextF1ow xmlngs="http : / /ns . adobe . Com/textLayout/2008"> 

<1mg SOu エ Ce="1maqge8/ SummerTmage2 .GTF" w1dth="30" he1ght="50"/> 1 
<span 1d="span1"> シ ステ ム 開 発 者 や 、 プ ログ ラミ ング まで 行う 一 部 の 高度 な パソ コン ユー ザ で 
し か 作る こと が 難し か っ た デス クト ッ プ アプ リケーション が 簡単 に 作れ る 時 代 に な り ま し た 。 
<b エ / > 
し か も その アプ リケーション は 動画 アニ メー ショ ン や ビデ オ の 才 生 を 行い 、 イ ンタ ーネット に アク セス ズ し 、 
組み 込ま れ た デー タベース エン ジン を 使用 し て 膨大 な デー タ を 高速 に 処理 する こと が で きま す 。 
</ SDan> 

</p> 

<1mg SOu エ Ce="1maqe8/ BummerTmaqe3 .GTF" width="30" heiqght="50"/> 

<D> 
<Span 1d="span2" FontSize="14">Adobe ATR(Adobe Tntegrated Run 
time ア ド ビ エア ー) は 、 個 人 の 趣味 や 実用 を 目的 と し た アプ リケーション だ け で な く 、 業 務 レ ベル に 
十分 耐え うる 機能 と 信頼 性 を 併せ 持つ アプ リケーション を 作成 する た め の 環 境 と 開発 方 法 を 提供 する イン 
プラ ま 。 

</ SDan> 

</p> 

</TextF1OW> : 


/ / 初期 化 の た め の 関 数 
Function nt () :vo1d { 
/ / テ キス ト を 表示 する オブ ジェ クト 
textContainer = new Sprite ( ) : 
textContainer.X = 10: ② 
textContainer.Y = 10: 
stage . addChi1d( textContainmer ): 
// デ フォ ルト の 書式 を 設定 


F1owFormat = new TextLayout 上 Forma ( ) : 
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FlowFormat .Co1or = Ox000000: 
F1owFormat .EontFam1i1y = "小塚 ゴシック Pro R, ゴシック , 明 朝 ": 
F1lOwFormat .FontSize = 16: 

PART //TextF1ow オ ブ ジ ェクト を 作成 し て 書式 を 適用 
F1OwData = 一 一 一 ーーー 一 ーーーーーーーーーーーーーーーーーーー (3 
TextCOnVerer . 1mDportTOF1ow (上 1EMarkup , TextConverter . TEXT LAYOUT_ 
FORMAT) : 
F]1owData . hostFormat = fF1owEForma : 
//TextF1ow を 表示 する た め の 表 示 コ ン テ ナ コン トロ ー ラ を 設定 
Var Contr : ContainerController = new ContainerContro1 1er (textContain 
er , ContainerW1QEth , ContainerHe1qht ) : 一 一 一 ーーーーーーーーーーーーーーーーーーーー ④⑳ 
/ / テ キス ト フ ロー を 制御 する た め の フ ロー コン ポー ザー を 設定 

FlowData .F1owComposer = new StandardF]1owComposer ( ) : 


FlowData .F1owComposer . aQdContro11er( contr ): 


⑥ 


FlowData . Fl1owComposer . updateA11Contro1 1ers ( ) : 


re 電 訂 


か ら 定 義 ご され た XML に よる TLF マ ー ク アッ プ デ ー タ を 読み 込ん で 、 表 示す る サン プル で す 。 
読み 込み は ③ で 行っ て お り 、TextFlow オ ブ ジ ェクト を 取得 し て いま す 。④ で 表示 コン テ ナ コ 
ント ロー ラオ ブ ジ ェクト を 作成 し て いま す が 、 第 1 パラ メー タ で 渡し て いる textContainer オ 
ブ ジ ェクト は 、⑧⑫ で 作成 、 表 示 リ スト に 追加 し て いる Sprite オ ブ ジ ェクト で す 。 さ ら に 、⑤ で 
行っ て いる よう に 、TLF テ キス ト の フロ ー を コン トロ ー ル する StandardFlowComposer オ ブ 
ジェ クト を 作成 し て 、TextFlow と ContainerController を 結び つけ る 必要 が あり ます 。 
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ロン シレ ルル くう: 





TLF ラ イブ ラリ は 、textLayout.swc フ ァイル で 提供 され 、 コ ン ポ ボー ネン ト 内 に は flashx. 
textLayout パ バッ ケ ー ジ が 格納 され て いま す 。 こ の パッ ケー ジ て 提供 され る バッ ケー ジ 配 下 の ク 
ラス が 、TLF ラ イブ ラリ の 主要 機能 に な り ま す 。 各 バッ ケー ジ の 概要 は P 146 の 表 「flashx. 
textLayout 内 の パッ ケー ジ 」 の と お り で す 。TLF ラ イブ ラリ は 、 大 きく 分 け て P.146 の 表 「TLF 
の クラ ス 機 能 分 類 ] の 3 種類 の クラ ス に 分 類 で きま す 。 分 類 は 、MVC デ ザイ ン パ ター ン に 類似 
し て で いる こと か ら 、 1 は は モデル, 2 は ビュ ー。 3 ば ほ は コシ トロ ー ラ と し て 分類 され ます 。 た だ し 
MVC は シス テム 開発 分 野 で 使用 され て きた デザ イン パタ ー ン で 、 必 ず 理 解す る 必要 は あり ませ 
ん 。TLF の 場合 、 モ デル は 構造 を 訪 む テキ ス ト デ ー タ で 、flow (フロ ー) と も 呼ば れ ま す 。 ピュ 
ー は その 名 の と お り 、 モ デル を 表示 オブ ジェ クト と し て 表示 する 過程 で す 。 コ ント ロー ラ は 、 
TLF の 場合 、 ユ ー ザ の 編集 操作 を モデ ル に 適用 し 、 イ ベン ト 処 理 も 提供 する 過程 で す 。 
TLFTextField は クラ シッ ク テ キ スト で ある TextField と 同様 に 、 テ キス ト の 表示 、 編 集 を 提供 
する TLF 対 応 ク ラス で す 。TLFTextField に TLF ク ラス に よる 書式 を 適用 する 場合 、textFlow プ 
ロ パ ティ で 提供 され る TextFlow オ ブ ジ ェクト を 使用 し ます 。TLF で は 、 テ キス ト デ ー タ の 構造 
は 、XHTML に 基づく エレ メン ト の 階層 構造 で 定義 され ます 。TextFlow オ ブ ジ ェクト は この テ 
キス ト デ ー タ 構造 の ルー ト オ ブ ジェ クト と し て 、 テ キス トコ ン テ ン ツ を 管理 し ます 。TextFlow 
オブ ジェ クト に スタ イル を 適用 する こと に より 、 文 書 全体 の スタ イル と する こと が で きま す 。 
TextFlow オ ブ ジ ェクト の スタ イル は hostFormat プ ロバ パテ ィ に 、 あ ら か じ め ス タイ ル を 設定 済 
み の TextLayoutFormat オ ブ ジ ェクト を 設定 する こと で 設定 し ます 。 


田 TLF の テキ スト デー タ 構 造 例 


TextFlOw 
DivElement DivElement 
ParagraphElement ParagraphElement ParagraphElement 
InlineGraphic SDanElement LinkElement TCYElement 


Element 
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馬 TLF の クラ ス 機 能 分 類 
No. | クラ ス の 機能 
テキ スト 自体 の 構造 と スタ イル 、 属 性 や テキ スト の 読み 込み 、 書 き 出し を 行い ます 


テキ スト の 表示 処理 を 行う ラク ラス 。 テ キス ト は FTE の TextLine イ ンス タン ス に 変換 され 、Flash 
Player で 表示 され ます 


| 3 | ユー ザ に よる テキ スト の 編集 と 選択 を 受け 付け 、 イ ベン ト 処理 も 提供 する クラ ス 





輸 flashx.textLayout 内 の パッ ケー ジ 








ルル ケー3 





パッ ケー ジ 内 クラ ス の 概要 機能 分 類 


フフ ロー コンポーザー を 定義 お よび 実装 する イン ター フェ イス と クラ ス が 含 
まれ ます 。 フ ロー コン ボー ザー は 、TextLine イ ンス タン ス へ の TextFlow の 
変換 お よび 1 つ 以 上 の コン テ ナ へ の TextLine イ ンス タン ス の 配置 を 管理 する 
オプ ジェ クタ ト で す 。 


container コン テ ナ に 表示 され る テキ スト を 管理 する た め の イ ンタ ー フ ii 中 議 
ス を 提供 し ます 。 


conversion | TextFlow オ ブ ジ ェクト に 対す る テキ スト の イン ポー ト 操 作 ま た は エク ドー 
ー ト 操作 に 使用 する クラ ス を 提供 し ます 。 


テキ スト を Text Layout Framework で 編集 する た め の ク ラス を 提供 し ます 。 


TLF の テキ スト デー タ 構 造 は この パッ ケー ジ が 提供 する クラ ス と イン ター 
フェ イス で 定義 S れ ます 。 テ キス ト 構 造 は 階層 ツリ ー 形 式 で 表現 され 、 ツ 
リー 内 の 各 ノ ー ド は この パッ ケー ジ 内 クラ ス の オブ ジェ クト に な り ま す 。 
上 図 「TLF の テキ スト デー タ 構 造 例 」 に 示し た 各 エ レ メ ン ト は この パッ ケー 
ジ の クラ ス に な り ま す 。 


events TLF で 使用 され る イベ ント クラ ス を 提供 し ます 。 


factory 読み 取り 専用 テキ スト を TLF で 構成 、 表 示す る た め の ク ラス を 提供 し ます 。 


formats テキ スト の フォ ー マ ッ ト を TLF で 表現 する た め の ク ラス を 提供 し ます 。 例 え 
ば 、TextLayoutFormat ク ラス は 、 次 の タイ プ の プロ パテ ィ の フォ ー マ ッ ト 
プロ パテ ィ を 定義 し ます 。 
・ フ ォ ン ト フ ァ ミ リ 、 サ イズ 、 カ ラー、 ス タイ ル 、 カー ニン グ 、 ト ラッ キン 
グ 、 大 文字 小文字 な どの フォ ント プロ パテ ィ 
行 送り 、 均 等 配置 の 調整 、 テ キス ト の 行 揃 え 、 イ ン デ ント な どの 段落 レベ 
ル の プロ パテ ィ 
・ 複 数 の 列 、 折 り 返 し 、 行 揃え 、 パ ディ ング 、 ベ ー ス ライ ン 位 置 合 わせ な ど 
の コン テ ナ レ ベル の プロ パテ ィ 


operationSs | テキ スト に 適用 する 操作 を Text Layout Framework で 編集 する た め の ク ラ 
ス が 含ま れ ま す 。 例 えば EditManager ク ラス は 取り 消し と や り 直 し を 複数 
の 段階 で 管理 し ます 。 


Text Layout Framework 用 の ユー ティ リティ クラ ス が 含ま れ ま す 。 


※ 機 能 分 類 : 番号 は 表 「TLF の クラ ス 機 能 分 類 ] の 番号 で 、 パ ッ ケ ー ジ の 機能 分 類 を 示し ます 人 ([ 
は 分 類 な し を 示し ます 。) 
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区 TextFlowv クラ ス の 主 な プロ パティ 


Configuration オ ブ ジ ェ [読み 取り 専用 ] TextFlow オ ブ ジ ェクト の Configur 
クト を 取得 する ation オ プ ジ ェ クト を 取得 で きま す 。 こ の プロ パテ 
ィ を 指定 し な い 場 合 、defaultConfiguration が 持 
つ プ ロ パ ティ が 使用 され ます 。 


[ 静 的 ] すべ て の 新規 TextFlow オ ブ ジ ェクト に 対し 
て 使用 され る デフ ォ ル ト の 構成 で す 。 構成 が 明示 的 
に 指定 され て いな い 場 合 に 使用 され ます 。 











COnT 1du エ a キ 1On : 
TConf 1qura キ 上 1on 
























すべ て の 新規 TextFlow オ | deEau1tConf igu 
ブ ジ ェクト に 対し て 使用 | ration: 

され る デフ ォ ル ト の 構成 | Configura 

を 設定 する tion 



























F]1OwComDpOo8er : 
TF1OwCOmDpO8er 


TextFlow を 表示 させ る た め に 使用 で きる IFlowCom 

poser を 実装 する イン スタ ンス に アク セス で きま す 。 
この イン スタ ンス に より 、 テ キス ト を 1 つ 以 上 の コ 

ン テ ナ に 関連 づけ 、 テ キス ト を コン テ ナ 内 で 表示 可 

能 に する IFlowComposer イ ンタ ー フ ェ イ ス で 定義 

され た メソ ッ ド を 呼び 出す こと が で きま す 。 


TextFlow オ ブ ジ ェクト の | generation:uint | [読み 取り 専用 ] TextFlow オ ブ ジ ェクト の 内 容 が 変 
世代 番号 を 取得 する 更 さ れる た びに 増加 する 世代 番号 を 取得 で きま す 。 


この TextFlow オ ブ ジ ェクト の フォ ー マ ッ ト を 定義 す 


FlowComposer オ ブ ジ ェ 
クト を 取得 する 









l 
S 

メ 
NO 


















TextLayoutFormat オ ブ | hostFormat: 











ジェ クト を 取得 / 設 定 す る | Elashx . る TextLayoutFormat オ ブ ジ ェクト を 取得 / 設 定 で 
ext 上 Layout . きま す 。 
Format8: 
TTGx ヒ ayOUu ヒ 


F ド Or エ ma 







この TextFlow オ ブ ジ ェクト の テキ スト の 選択 と 編集 
を 制御 する InteractionManager を 取得 / 設 定 で き 
ます 。 


InteractionManager オ | interacioOn 
Sa ト を 取得 / 設 定 す | Manager : TSe1ec 


上 1onManader 






急 TextFlow クラ ス の 主 な メソ ッ ド 


エレ メン ト を id で 取得 する getElementByTD ( オブ ジェ クト 内 で idName に 一 致す る id プロ 
1dName : String パテ ィ を 持つ エレ メン ト を 返し ます 。 
) : FlowElemen 


エレ メン ト を 名 前 で 取得 する | getEg1ementsBy styleNameValue が 示す 値 の styleName を 
Sty1eName ( 持つ すべ て の エレ メン ト を 配列 で 返し ます 。 


8 上 yleNameValuGe : 
S 了 1nd 
) : ム A ム エエ aY 


フォ ー マ ッ ト の 再 計算 を 強制 | inva11idateA1 1 スタ イル を 変更 し た 後に 、TextFlow の すべ 
する Formats ( ) : て の フォ ー マ ッ ト 情 報 を 無効 化し 、 フ ォ ー 
vo1d マッ ト の 再 計算 を 行い ます 。 
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答 TextFlovw クラ ス の 主 な イベ ント 


フロ ー オ ペレ ーション が | E1owOperationBegin イベ ント を キャ ン セ ル す る と 、 操 作 が ブ 
開始 する 前 (定数 FlowOperationEvent. | ロッ ク さ れ ま す 。 
FLOW_OPERATION_BEGIN) 


フロ ー オ ペレ ーション が | El1owOperationComplete | フロ ー オ ペレ ーション が 完了 後に 送出 さ 
終了 し た (定数 FlowOperationEvent. | れ ま す 。 

FLOW_OPERATION_COMP 

LETE) 


3 フロ ー オ ペレ ーション の | fl1owOperationEnd フロ ー オ ペレ ーション が すべ て 終了 し て 表 
すべ て の 処理 が 終了 し た | (定数 FlowOperationEvent. | 示 が スク ロー ル さ れ た 後に 送出 され ます 。 
FLOW_OPERATION_END) 


InlineGraphicElement の | in1ineGraphicStatusCh | 幅 ま た は 高 さ が auto ま た は パー セン ト に 


サイ ズ が 変更 され た anged 指定 され て グラ フィ ッ ク の ロー ド が 完了 
し た た め に InlineGraphicElement の サイ 
ズ が 変更 され た 場合 に 送出 され ます 。 


マウ ス 操 作 が 行わ れ た mouseDown 各 マ ウス 操作 が 行わ れる と 送出 され ます 。 
mOu8eUD 
mOuSeGMOV6 
rO11Ou 七 
OL1OVer 


テキ スト が コン トロ ー ラ テキ スト が コン トロ ー ラ コン テ ナ 内 で ス 
コン テ ナ 内 で スク ロー ル クロ ー ル され る と 、TextFlow オ ブ ジ ェ ク 
され た ト に より 送出 され ます 。 


選択 が 変更 され た テキ スト の 選択 が 変更 され る た びに 送出 
され ます 。 


コン テ ナ の 構成 が 変更 さ | updateComplete コン テ ナ に 新規 の 表示 オブ ジェ クト が 追 

れ た 加 さ れ た り 、 構 成 の 結果 と し て コン テ ナ 
が 更新 され る た びに 、TextFlow オ ブ ジ ェ 
クト に より 送出 され ます 。 
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1.1.4.RA と デス クト ッ プ アプ リ 

ケー ショ ン を 理解 する AIR は 、 

リッ チイ ンタ ーネット アデ アプリケ ー 
ンション (RIA) を デス クト ッ プ アプ リ 
ケー ショ ン と し て 実行 する 環境 で 
す 。RA と いう 言葉 の 意味 と あわ 
せ て 、 こ の 文 が 意味 する と ころ を 
理解 し まし ょ う 。 リ ッ チ イン ター 
ネッ ト ア プリ ケー ショ ン (RIA) と は 
RIA と は 、Adobe 社 と 人 台 併 する 前 
| の Macromedia 社 が 2002 年 に 提 嘱 
| し た 組 念 で 、HTML ベ ー ス で な く 

| Flash に 代表 され る GUI ペ ー ス の 高 
| 度 な ユー ザ 体 険 を も た ら す イン 

| ター ネッ ト ア プリ ケー ショ ン を 電 
| 味 し ます 。 一 般 的 な 特徴 と し て 、 

| RA は Web ア プリ ケー ショ ン で あ 
則 る た め 、 ブ ラウ ザ 上 で 実行 され ま 
| す 。 そ の た め 、 通 常 Web サ ー パ に 
| 接続 し て コン テン ツ を ダウ ン ロ ー 
還 ド し た り 、 ア ッ プ ロー ド し ます 。 


ll その た め 、RIA コ ン テ ン ツ を 実行 


間 する 場合 、 イ ンタ ーネット エク ス 
則 プロ ー ラ (IB や FireFox、Safarl な ど 
則 の ブラ ウザ が 使用 され ます 。( た 
だ し 、 イ ン フ ラ に よっ て は ブラ ウ 
| ザ 不 要 の 実行 形態 を サポ ー ト する 
も の も あり ます 。)AIR の 場合 
| AIR の 特徴 2 は 、「 リ ッ チ イン 
l ター ネッ ト ア プリ ケー ショ ン (RIA) 
胃 を デス クト ッ プ アプ リケーション 
| と し て 実行 させ る こと が で きる 」 
上 | と いう こと で し た 。 こ こと で 「 デ ス 
q』 クト ッ プ アプ リケーション 」 と あ 


えて 宣言 する の は 、「 ブ ラウ ザ 上 
で 実行 し な い 」 と いう 意味 で す 。 
少し 詳し くま と め る と 、RA は 次 
の よう な 機能 を 持つ アプ リ ケ ー 
ショ ン で す 。HTML ベ ペー ス で は な 
く 、 Flah コ ン テ ン ツ の よう な GuUlI 
ペー ス で ある ペー ジ 更 新 を 行う た 
め に Web サ ー バ に アク セス し な く 
て も よい サー バ か ら デ ー タ を 取得 
する 場合 、 必 要 な デー タ の み を 取 
得 で き 、 ペ ー ジ 全体 を 更新 する 必 
要 が な いつ まり 、R 愉 と は 「GUI 
ベー ス の 美しい レイ アウ ト に よ 
る 、 高 機能 、 高 パフ ォ ー マ ンス な 
Web ア プリ ケー ショ ン 」 で す 。 技 
術 的 に は 次 の よう な 定義 に な り ま 
す 。 CUI に よる 高い 操作 性 や 視認 
性 (リッ チ な ユー ザー イン タ 
フェ ー ス と 表現 力 を 提供 ) クラ 
イア ント マシ ン で 多く の 処理 を 行 
う の で 、 サ ー バ の 負荷 が 軽い 
ネッ トワ ー ク の 負荷 が 軽い RIA の 
よう に クラ イア ント 側 で 多く の 処 
理 友 行 う 形 態 を 「Fat dient」、 遂 
に サー バ 仙 で 多く の 処理 を 行う 形 
態 を 「Thin dient」 と 呼び ます 。 
Fat dient が 発展 し て きた 音 景 に 
は 、 パ ソコ ン の 基本 性 能 が 大 きく 
向上 し た こと が 拳 げ られ ます 。 
AIR も Flas 技 術 を 使用 する RA の 
一 員 で す が 、AIR は 則 時 に 「 デ テス 
クト ッ プ アプ リケーション 」 で も 
あり ます 。 こ れ は 、AIR が 次 の よ 
うな 特徴 を 持つ こと を さ し ま す 。 


Web サ ー バ に アク セス する 機能 を 
持つ イン ター ネッ ト ア プリ ケー 
ショ ン で ある その 実行 に ブラ ウ 
ザ は 必要 な く 、OS に イン スト ー 
ル さ れ た アプ リケーション と し て 
動作 する 前 節 で みた よう に 、 ぁ AI 
アプ リケーション は AIR ラ ンタ イ 
ム が イン スト ー ル され て いれ ば 、 
プラ ウザ で は な く 、OS に イン ス 
トー ル さ れ た アプ リケーション と 
し て 実行 で きま す 。 AIR ア プリ 
ケー ショ ン は ブラ ウザ 不要 の RI 
この こと か ら 、AIR で は 通常 の R は 
で は 実現 不可 能 な 様々 な 機能 を 実 
現 で きま す 。 詳しく は 、1.3 AIR で 
作成 で き る アプ リケーション を 
ご ご覧 くだ さい 。 そ の 他 の RIA イ ン 
フラ RI 分 野 で は 、 す で に Adobe 
Flex が 世界 標 稚 と な っ て いま す 
が 、 そ の 他 の イン フラ キ も 存在 し ま 
す 。 こ こ で は 代表 的 な も の を いく 
つか ご 紹介 し ます 。RIA と は 当初 
Flash に よる 高 機能 な Web ア デ プ リ 
ケー ショ ン を さして いま し た が 、 
最近 で は JavaScript を 使用 する 
Ajax や 、Fla 中 技術 を 使用 する 
Open Lalo、MITT マ サチ ュー 
セッ ツ 工 科大 学 ) で 開発 され た Curl 
な ど 、 様 々 な RA 開発 イン フラ が 
リリ ー ス され ね て いま す 。 Mcrosoft 
社 も 2007 年 に Sllverlight と いう 名 
称 で RA の フレ ー ム ワー ク ( 律 組み ) 
を 発表 し 、 コ ン テ ン ツ 制 作 関連 製 
唱 を リリ ー ス し 、 本 格 的 な 取り 組 
み を 始め て いま す 。 
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ーーーー- _ ーー Res レ ee 


に 








= た W% 目 = 首 叶 me】 コ 粒 -----ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


TLFTextField の hostFormat で TLF 書式 を 適用 する 


※ 実 行 に は FlashCS5 が 必要 TLFfextFlowFormatSample.fla 


1mport Flash . even8 . EVen : 

1mport fl]ashx .textLiayOut . Formatg . Text 上 LayOut 上 FOrma : 
1mport fF]ashx .textLiayout . elementg . TextF1Ow: 

1mport F]ashx .textLayout . Container . Conta1nerContro1 1e エ : 
1mport Fl]ashx .textLiayOUu . COnVer81On . Gxt 上 COnVG ェ GT : 
1mport fF]ashx .textLiayOut . Compose . StandardF1OwCOmDpO8er: 
1mport myPackage .T1ESamplePlainTex : 

/ / 表 示 コ ン テ ナ 

Ya textConta1ner : SDF1 ユ 巧 G : 

/ / コ ン テ ナ サイ ズ 

var ContainerHe1qht :Numbper = 500: 

Yar ContainerW1Qdth :Number = 780: 

/ / テ キス ト フ ロー と 書式 の た め の オ ブ ジ ェクト 変数 

var fF1owData : TextF1Ow: 

var fF1owFormat : TextLayOu 上 Forma : 

uno は QR : ま も て) 0 の で や 


( 
/ / テ キス ト を 表示 する オブ ジェ クト 
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extConta1ner = new SDpr1e ( ) : 

textConta1ner.x = 10: 

texEContainer.Y = 10: 

8Eaqe . addCh11d( textConta1ner ): 

// デ フォ ルト の 書式 を 設定 

F1owFormat = new TextLiayoutFormat () : 

F1owFormat .Color = Ox000000: 

FE1owFormat .FontFam11y = "小塚 ゴシック Pro R, ゴシック , 明 朝 ": 
F1OowFormat .fontS1ze = 14: 

//TextF1ow オ ブ ジ ェクト を 作成 し て 書式 を 適用 

FlowData = TextConvVerer . 1mportToF1ow (TIFSamplePlain 
Text .p1a1nString, TextConverter . PLATN TEXT FORMAT) : 一 ③④ 
F1owData . hostFormat = fF1OwEForma : 

// デ フォ ルト の コラ ム 設 定 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
F]owData . columnCount = 2: 

F1owData . columnGap = 0: 

Fl1owData . columnW1dth = 200: 

/ /TextF1ow を 表示 する た め の コ ン ポ ー ザ ー を 設定 

Ya CoOn キ 了 : Cont 上 a1nerCon 上 ro11er = new Conta1inerContro1 1er 
(textContainer , ContainerW1dth , conta1inerHe1qht ) : 
Fl1owData .E1owComposer = new StandardF1owComposer ( ) , : ⑥ 
FlowData . FlowComposer . adQContro11er( contr ): 

F1lowData .f1owComposer . updateA11Contro11ers ( ) : 

/ / コン ポー ネン ト の コラ ム 数 、 ギ ャ ッ プ 、 幅 、 書 式 値 を 設定 : 

TLF Co1ummCountNumer1CSeDDer .Value = 2: 

TLF CoO1umnGapNumer1CSteDDer .VaLue = 1: 

TLE Co1umrmW1QdthNumer1CSteDper .Value = 200: 

ColorPicker. selectedCol1or = Ox000000: 

81ZGNumer1CSteDDper .Value = 14: 

/ / イ ベン トリ スナ ー 

TLF ColumrnCountNumer1CSeDpDer . adQdEventL1stener ( Event .CHANGE , 
setT1EColumms ): 

TLF Co1umnGapNumer1CSteDDper . adQdEventLi1 stener( Event .CHANGE , 
SetTlEColumms ): 

TLF Co1umnW1dthNumer1CStepper . addEventListener ( Event .CHANGE , 
SetT1FCo1ummns ): 

Co1orP1Cker . adQdEventL1gtener ( Event .CHANGE, setT1FFormat ): 
81ZeGNumer1CStepper . adQdEventLi1istener( Event .CHANGE, setT1fFEormat ): 
FonECombo . addEventL1gstener ( Event .CHANGE, setT1FEFormat ): 
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) 
/ /TLF に よる コラ ム 制 御 を TextF1ow オ ブ ジェ ト に 適用 


Funct1on setT1FCo1umns (event : Event ) :Yo1d 


( 


8w1toch ( evenrnt .tarqet .name ) 
( 

Ca8e "TLE Co1umnCountENumer1iCSteDDer" 
Fl1owData . Co1ummCoun 七 = event .tarqdet . ゞ Ya1ue : 
break : 

Case "TLEF Co1ummGapNumer1CSteDDer" 
F1owData . ColumnGap = event .arqe .Ya1ue : 
DreaK 

Case "TLEF Co1ummnW1dthNumer1CSteDDer" 


回 


Fl1owData . ColumnW1dth = event .tarqget .Ya1ue : 


Dreak : 


) 


FlowData .E1owComposer . updateA11Contro1 1ersg ( ) : 
) 
//TLF に よる フォ ー マ ッ ト 設 定 : 
Function setT1FFormat (event : Event ) :vo1d 


( 





③ 


/ / フォ ー マ ッ ト を 定義 する TextLiayoutFormat 上 オブ ジェ クト 

FlowFormat = new TextLayoutFormat ( ) : 

F1OwEFormat .Col1Or = ColorPioker . SelectedCo1or : 

Fl1OwFormat . FontFam11y = FontCombo . se1ectedTtem . daa : 
F1owFormat . FontES1ze = 81zeNumer1icCStLeDDer . Ya1uG : 

//TextF1ow オ ブ ジ ェクト に 適用 

FlowData . hostFormat = F]owEorma : 

//fE1owComposer の メゾ ソ ッ ド で ピュー を 更新 

FlowData . 1owComposer . updateA11Contro1 1erg ( ) : 一 ーーーーーーーーーーーーーーーーー ③⑬ 


1n1 七 ( ) : 


いか ら の init() 関 数 で 、TLF テ キス ト の テキ スト 読み 込み 、 書 式 設 定 、 表 示 を 行っ て いま す 。 
@ で 表示 の た め の コ ン テ ナ と し て Sprite オ ブ ジ ェクト を ステ ー ジ に 配置 し て いま す 。③ で テキ 
スト テー タ の 読み 込み (④) と 書式 の 設定 を 行っ て いま す 。⑥ で 、 フ ロー デー タ を 表示 する た め 
の 処理 を 行っ て いま す 。⑤ か ら は 、 コ ン ボ ボッ クス な どの 設定 で す 。⑦ か ら の 関数 で 、TLF に 
よる 書式 変更 を 行っ て いま す が 、⑧ で 行っ て いる よう に ビュ ー を 更新 する 必要 が あり ます 。 
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TLF エレメント の スタ イル 設定 を 行う 





PART TLF の テキ スト デー タ 構 造 は 、TextFlow オ ブ ジ ェクト を ルー ト と する flashx.textLayout. 
elements バ パッケ ー ジ クラ ス の 階層 構造 で す 。 そ れ ぞ れ の エレ メン ト は TextFlow ク ラス の 
getElementByID() メ ソ ッ ド や getElementByStyleName() メ ソ ッ ド で 取得 で きま す 。 取 得 し 
た エレ メン ト は ltextLayoutFormat イ ンタ ー フ ェ イ ス を 実装 する FlowElement ク ラス の 子 係 
クラ ス で 、 主 に この クラ ス の プロ パテ ィ に よっ て スタ イル の 設定 を 行い ます 。 


圭 FlowElement ク ラス の 主 な プロ バテ ィ 
プロ パテ ィ の 概要 







































































| 目的 ] プロ パテ ィ 名 
ベー スラ イン を 指 | a11gnment 行 の 基準 揃え る ベー スラ イン を 指定 し ます 。 

定 す る Ba8e] 1ne :* デフ ォ ル ト 値 : undefined 
育 景 の アル ファ 値 | backqground 育 景 の アル ファ 値 を 指定 し ます 。 
を 指定 する Alpha : NumDer デフ ォ ル ト 値 : 1.0 

| ] ] 
有 景 の 色 を 指定 す | backqround 育 景 の 色 を 指定 し ます 。 
る Co1or : un | デフ ォ ル ト 値 : undefined 
ベー スラ イン を 移 | base1ineShift ベー スラ イン を dominantBaseline 値 か ら 移 動 さ せる 量 を 
動 さ せる 朗 -1000 て 1000 の 範囲 で 指定 し ます 。 


デフ ォ ル ト 値 : undefined 


垂直 方 向 ま た は 水平 方 向 の 行 配置 を 指定 し ます 。 
flashx.textLayout.formats.BlockProgression.TB : 
上 か ら 下 ( 横 書 ) 
flashx.textLayout.formats.BlockProgression.RL : 
右 か ら 左 (日 本 語 や 中 国語 な どの 縦 書 ) 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


改行 可能 位置 を 制 | breaKODpOr 折り 返し の ある テキ スト を 複数 行 に 分 割 す る 際 の 、 改 行 
側 す る Eun1y :* 可能 位置 を 制御 し ます 。 
flash.text.engine.BreakOpportunity.ALL : 

すべ て の 文字 が 、 改 行 を 行う か どう か の 判断 に 使用 され 
ます 。 文字 ご と に 改行 が 行わ れ ま す 。 

| flash.text.engine.BreakOpportunity.ANY : 

オブ ジェ クト 内 の 文字 が 、 改 行 を 行う か どう か の 判断 に 
使用 され ます 。 
flash.text.engine.BreakOpportunity.AUTO : 
文字 プロ パテ ィ に 基づい て 改行 を 行う か どう か を 判断 し 
ます 。 

flash.text.engine.BreakOpportunity.NONE : 

オブ ジェ クト 内 の 文字 は 、 改 行 を 行う か どう か の 判断 に 
使用 され ませ ん 。 
flashx.textLayout.formats.FormatValue.INHERIT 
親 の 値 を 継承 し ます 。 











ee 


王 直 / 水 平方 向 の | DLOCKProqre 
行 配置 を 指定 する | ssion :Ob]ject 




















ーーーー イ ヤー 
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6-1-4 
TLF エ レ メ ン ト の スタ イル 設定 を 行う 


動 FlovElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


テキ スト の 色 を 取 | co1or : * RGB ( 赤 、 緑 、 青 ) 値 を 指定 する 16 進 値 を 指定 し ます 。 
得 / 設 定 する デフ ォ ル ト 値 : undefined 


テキ スト 列 の 数 を | co1umnCount : * テキ スト 列 の 数 を 1 て 50 の 整数 で 指定 し ます 。 数値 を 指 
指定 する 定 し な いで 次 の 値 を 指定 で きま す 。 

列 間 の ふち 取り 領 | ColumnmGap : * 
域 キ ャ ッ プ を 指定 
する 


flashx.textLayout.formats.FormatValue.AUTO : 
ーー 


自動 的 に 決定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
数 字 の 大 文字 / 小 文 | d1qitCase :* 
字 タ イプ を 指定 す 


税 の 値 を 継承 し ます 。 
る 







デフ ォ ル ト 値 : undefined 


列 間 の ふち 取り 領域 を 0 て 1000 の ピク セル 単位 で 指定 し 
ます 。 数値 を 指定 し な いで 次 の 値 を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


列 幅 を 0ー8000 の ピク セル 単位 で 指定 し ます 。 数値 を 指 
定 し な いで 次 の 値 を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.AUTO : 
目 動 的 に 決定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


テキ スト に 使用 され る 数 字 の 大 文字 / 小 文字 の タイ プ を 
表 し ま す 。 

flash.text.engine.DigitCase.DEFAULT : 

デフ ォ ル ト の 数 字 の 大 文字 / 小 文字 を 使用 し ます 。 
flash.text.engine.DigitCase.LINING : 

ライ ニン グ 数 字 の 大 文字 / 小 文字 を 指定 。 
flash.text.engine.DigitCase.OLD_STYLE : 

オー ルド スタ イル 数 字 の 大 文字 / 小 文字 を 指定 し ます 。 











































lining 1234567S90 
oldStyle jsj4567Sgo 







flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


テキ スト に 使用 され る 数 字 の 幅 の タイ プ を 表し ます 。 
flash.text.engine.DigitWidth.DEFAULT : 

デフ ォ ル ト の 数 字 の 幅 を 使用 し ます 。 
flash.text.engine.DigitWidth.PROPORTIONAL : 
プロ ボー ショ ナル 数 字 の 幅 を 指定 し ます 。 
flash.text.engine.DigitVWidth.TABULAR : 

等 幅 数 字 の 幅 を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
灯 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 











数 字 の 幅 の タイ プ | digitW1dth:* 
を 指定 する 
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6- 1 
Text Layout Framework (TLF) 


怠 FlowElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


左右 方 向 の 読み 順 | d1rect1On:* テキ スト ブロ ッ ク 内 に ある テキ スト の デフ ォ ル ト の 双方 
向 埋め 込み レベ ル を 指定 し ます 。 
flashx.textLayout.formats.Direction.LTR 

左 か ら 右 へ の 向き を 指定 し ます 。 
flashx.textLayout.formats.Direction.RTL : 

右 か ら 左 へ の 向き を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT . 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 
















































Qdom1nan 二 
Ba8el1ne:* 








行 エ レ メ ン ト の 垂 
直 座 標 を 決め る ベ 
ー ス ライ ン を 指定 
する 


行 の エレ メン ト の 垂直 座標 を 決定 する た め に alignment 
Baseline に 吸着 させ る エレ メン ト の ベー スラ イン を 指定 
し ます 。 

flashx.textLayout.formats.FormatValue. AUTO : 
親 段落 の locale プ ロ パ ティ に 基づい て 、 行 の 基準 が 選択 
され ます 。 

flash.text.engine.TextBaseline.ROMAN : 

欧文 ベー スラ イン を 指定 し ます 。 
flash.text.engine.TextBaseline. ASCENT : 

アセ ント の ベー スラ イン を 指定 し ます 。 
flash.text.engine.TextBaseline.DESCENT : 

ディ セン ト の ベー スラ イン を 指定 し ます 。 
flash.text.engine.TextBaseline.IDEOGRAPHIC_TOP : 
文字 の 最上 部 の ベー スラ イン を 指定 し ます 。 
flash.text.engine.TextBaseline.IDEOGRAPHIC_CEN 
TER : 文字 の 中 心 の ベー スラ イン を 指定 し ます 。 
flash.text.engine.TextBaseline.IDEOGRAPHIC_BO 
TTOM : 文字 の 最 下 部 の ベー スラ イン を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


コン テ ナ 内 の 最初 の 行 の ベー スラ イン 位置 を 0 一 1000 の 
数 値 で 指定 し ます 。 下記 の 定数 も 使用 で きま す 。 
flashx.textLayout.formats.BaselineOffset.AUTO : 
行 の アセ ント と コン テ ナ の 上 部 の イン セッ ト を 揃え ます 。 
flashx.textLayout.formats.BaselineOffset.ASCEN 
T : 行 の アセ ント と 等 し い オ フ セ ッ ト を 指定 し ます 。 
flashx.textLayout.formats.BaselineOffset.LINE_ 
HEIGHT : 行 の 高 さ と 等 し い オ フ セ ッ ト を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


使用 する フォ ント 名 また は フォ ント 名 の カン マ 区 切り リ 
スト を 指定 で きま す 。 
デフ ォ ル ト 値 : undefined 















firstBa8e 1ne 
OFF8ge:* 


最初 の 行 の ベー ス 
ライ ン 位 置 を 指定 
する 






























フォ ント 名 を 取得 
/ 指 定 する 


FontFam11y:* 





6-1-4 
TLF エ レ メ ン ト の スタ イル 設定 を 行う 


箇 FlowElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


フォ ント ルッ クア | fontLookup : * 使用 する フォ ント 参照 を 表し ます 。 
ッ プ を 取得 / 指 定 す 
る 


flash.text.engine.FontLookup.DEVICE : 
フォ ント サイ ズ を | fontSize :* 
取得 / 指 定 する 


デバ イス フォ ント の ルッ クア ッ プ を 示し ます 。 
フォ ント の 斜体 ス | EontSty1e :* 
タイ ル を 取得 / 指 
定 する 


flash.text.engine.FontLookup.EMBEDDED _CFF : 

埋め 込み CFF (コン パク ト フ ォ ン ト フ ォ ー マ ッ ト ) フォ ン 
ト の ルッ クア ッ プ を 示し ます 。 

フォ ント の ウェ イ | fontWeight :* 

トス タイ ル を 取得 

/ 指 定 する 













flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


1<720 の 数 値 で デキ スト サイ ズ を 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


テキ スト の 立体 スタ イル を 表し ます 。 
flash.text.engine.FontPosture.NORMAL : 

標準 の フォ ント 傾斜 を 示し ます 。 
flash.text.engine.FontPosture.ITALIC : 

イタ リッ ク 体 の 傾斜 を 示し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


テキ スト の 太 さ を 表し ます 。 
flash.text.engine.FontWeight.NORMAL : 

標準 の フォ ント 太 さ を 示し ます 。 
flash.text.engine.FontWeight.BOLD : 

ボー ルド フォ ント の 太 さ を 示し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
有 親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 







































Format :Flashx . 
ex 二 ayOUu . 

Formatg : TTextLa 
YOutFOrma ヒ 


フォ ー マ ッ ト を 指 
定 す る 


TextLayoutFormat オ ブ プ ジ ェ クト で エレ メン ト に 適用 す 
る スタ イル を 指定 で きま す 。 










1d : Strind 





識別 名 を 割り 当て ます 。TextFlow ク ラス の メソ ッ ド で 、 
この id を 使用 し て エレ メン ト オ ブ ジェ クト を 取り 出す こ 
と が で きま す 。 


段落 の テキ スト の 均等 配置 に 使用 する ルー ル を 表し ます 。 
flashx.textLayout.formats.JustificationRule.EAST_ 
ASIAN : 日 中 韓 の 均等 配置 ルー ル を 示し ます 。 
flashx.textLayout.formats.JustificationRule.SPACE : 
スペ ー ス を 使用 し て 単語 を 分 割 す る 、 ラ テン 語 な どの 横 
書き スク リプ ト の 均等 配置 を 示し ます 。 
flashx.textLayout.formats.FormatValue.AUTO : 
段落 の locale プ ロ パ ティ に 基づい て テキ スト の 均等 配置 
が 行わ れ ま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


id を 取得 / 設 定 する 





















段落 テキ スト の 均 
寺 配 置 ル ー ル を 取 
得 / 設 定 する 


Ju8t1F1cat 上 ュ on 
Ru1G:* 
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6- 1 
Text Layout Framework (TLF) 


蘭 FlowElement ク ラス の 主 な プロ バテ ィ ( 続 き ) 


段落 の 均等 配置 ス | 〕ust1fiCat1on 段落 の 均等 配置 に 使用 する スタ イル を 表し ます 。 

タイ ル を 取得 / 設 | SEyle:* flash.text.engine.JustificationStyle.PRIORITIZE_LE 
定 す る AST_ADJUSTMENT : 行 の 拡張 また は 圧縮 (必要 な 幅 に 
も っ と も 近い 結果 が 得 ら れる ほう ) に 応じ て 、 均 等 配置 
し ます 。 
flash.text.engine.JustificationStyle.PUSH_IN_ 
KINSOKU : 行末 の 圧縮 され る 禁則 に 応じ て 、 ま た は 禁 
則 が な い 場 合 や スペ ー ス が 不足 し て いる 場合 の 拡張 に 応 
じ て 、 均 等 配置 し ます 。 
flash.text.engine.JustificationStyle.PUSH_OUT_ 
ONLY : 行 の 拡張 に 応じ て 均等 配置 し ます 。 
flashx.textLayout.formats.FormatValue.AUTO : 
すべ て の ロケ ー ル で JustificationStyle.PUSH_IN_KINS 
OKU に 解決 され ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


カー ニン グ が サポ ー ト され る フォ ント で カー ニン グ を 有 
効 に し ます 。 

flash.text.engine.Kerning.ON : 

カー ニン グ を 有効 に し ます 。 
flash.text.engine.Kerning.OFF : 

カー ニン グ を 無効 に し ます 。 
flash.text.engine.Kerning.AUTO : 

アジ ア 系 文字 の テキ スト 編集 で 不適 切な 場合 を 除き 、 カ 
ー ニ ング を 有効 に し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


行 送り モデ ル を 取 | 1eadingMode1 :* 行 送り の 基準 と 行 送り 方 向 の 組み 合わ せ で ある 、 行 送り 

得 / 設 定 する モデ ル を 指定 し ます 。 
flashx.textLayout.formats.LeadingModel.ROMA 
N _UP : 行 送り 基準 が ROMAN で 行 送り の 方 向 が UP を 示 
し ます 。 
flashx.textLayout.formats.LeadingModel.IDEOGR 
APHIC_TOP_UP : 行 送り 基準 が IDEOGRAPHIC_TOP で 
行 送り の 方 向 が UP を 示し ます 。 
flashx.textLayout.formats.LeadingModel.IDEOGR 
APHIC CENTER_UP : 行 送 り 基 準 が IDEOGRAPHIC_C 
ENTER で 人 行 送り の 方 向 が UP を 示し ます 。・ 
flashx.textLayout.formats.LeadingModel.IDEOGR 
APHIC_TOP_DOWN : 行 送り 基準 が IDEOGRAPHIC_T 
OP で 行 送り の 方 向 が DOWN を 示し ます 。 
flashx.textLayout.formats.LeadingModel.IDEOGR 
APHIC CENTER_DOWN : 行 送り 基準 が IDEOGRAPH 
IC_CENTER で 行 送り の 方 向 が 下方 向 を 示し ます 。 
flashx.textLayout.formats.LeadingModel.APPRO 
XIMATE_TEXT_FIELD : TextField の 行間 の ビヘイビア 
ー と ほぼ 同じ に な る 行 送り モデ ル を 示し ます 。 














































カー ニン グ を 取得 
/ 設 定 する 





kern1nd:* 


6-1-4 
TLF エ レ メ ン ト の スタ イル 設定 を 行う 


怠 FlowElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


プロ パテ ィ 名 プロ パテ ィ の 概要 


flashx.textLayout.formats.LeadingModel.ASCEN 
T_DESCENT_UP : 行 送り 基準 が ASCENT/DESCENT で 
行 送 り の 方 向 が UP を 示し ます 。 
flashx.textLayout.formats.LeadingModel.AUTO : 
段落 の locale プ ロ パ ティ に 基づい て 解決 され ます 。 日 本 
語 と 中 国語 で LeadingModel.IDEOGRAPHIC_TOP_DO 
WN、 他 の すべ て の 言語 で LeadingModel.ROMAN_UP_ 
UP と な り ま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 

テキ スト の 折り 返 | 11ineBreak : * テキ スト 折り 返し を 制御 し ます 。 

し を 制御 する flashx.textLayout.formats.LineBreak.EXPLICIT : 1 
明示 的 な 改行 文字 また は ライ ン フ ィ ー ド 文字 で の み 改 行 
する よう に し ます 。 
flashx.textLayout.formats.LineBreak.TO_FIT : 
コン テ ナ 幅 に 合わ せ て 行 を 折り 返す よう に し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 

有 親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


テキ スト の 行 送り | 11neHe1ght :* -720…720 ま た は -1000 て 1000% の 範 胃 で テキ スト の 
を 制御 する 行 送り を 制御 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


打ち 消し 線 を 描画 | ineThrough:* 打ち 消し 線 の 描画 を 指示 し ます 。 

する true : 打ち 消し 線 を 表示 し ます 。 設定 し て いる 祖先 が な 
い 場 合 、false に な り ま す 。 
デフ ォ ル ト 値 : undefined 


テキ スト の ロケ ー | 1oca1e :* テキ スト の ロケ ー ル を 表し ます 。 日 本 語 の 場合 ja で す 。 
ル を 取得 / 設 定 す る 


コン テ ナ と テキ ス | paddingTop :* コン テ ナ の 下部 の 上 端 / 下端 / 左 端 / 右 端 と テキ スト の 間 の 
ト の 間 の スペ ー ス | paddingBottom:* | スペ ー ス を 0 一 1000 の ピク セル 値 で 指定 し ます 。 数 値 ま 
を 指定 する padd1ngLef :* た は 次 の 値 を 指定 で きま す 。 
paddingR1ght :* flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 









段落 の 始 端 / 終 端 | DaragraphStar 上 段落 の 始 端 / 終 端 を どれ だ け イ ン デ ント する か を 0 て 1000 
の イン デン ト を 取 | tndent :* の ピク セル 値 で 指定 し ます 。 左 か ら 右 の テキ スト で は 右 
得 / 指 定 する paragraphEnd 端 、 右 か ら 左 の テキ スト で は 左端 の イン デン ト で す 。 
TnQdent :* flashx.textLayout.formats.FormatValue.INHERIT : 
有 親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 
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6- 1 
Text Layout Framework (TLF) 


葵 FlowElement ク ラス の 主 な プロ パテ ィ (続き ) 


PART 
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段落 の 前 / 後 ろ に 
空け る スペ ー ス を 
取得 / 指 定 する 


親 オ ブ ジ ェクト を 
取得 する 


レ し が リル シダ が ギー 
ド を 取得 / 設 定 す 
る 


スタ イル 名 を 取得 
/ 設 定 する 


タブ スト ッ プ を 取 
得 / 設 定 する 


ParadraphSpaCe 
BeFEOr@ :* 
ParadraphSpaCe 
ム AF 上 @G:* 


Dar エ en : 
F1OWGrOUD 
E]emen 


reGnder1nqMode : * 


8 上 leName : 
S キ 上 エ 1nJ 


LaDStOD8 : * 


段落 の 前 / 後 に 空け る スペ ー ス を 0 て 1000 の ピク セル 値 
で 指定 し ます 。 左 か ら 右 の テキ スト で は 右端 、 右 か ら 左 
の テキ スト で は 左端 の イン デン ト で す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


[読み 取り 専用 ] オブ ジェ クト の 親 を 取得 で きま す 。 


テキ スト に 使用 され る レン ダリ ング モー ド を 表し ます 。 
埋め 込み フォ ント (fontLookup プ ロ パ ティ が FontLook 
up.EMBEDDED_CFF に 設定 され て いる 場合 ) に の み 有 効 
で ます 。 


エレ メン ト に 設定 する スタ イル 名 を 表し ます 。TextFlow 
クラ ス の メソ ッ ド で 、 ス タイ ル 名 か ら エ レ メ ン ト を 取得 
する こと が で きま す 。 
flash.text.engine.RenderingMode.NORMAL : 

レン ダリ ング モー ド を 、 Flash Player 7 以前 で 使用 され て 
いる レン ダリ ング モー ド に 設定 し ます 。 
flash.text.engine.RenderingMode.CFF : 

し PF(【 コ ロッパ クト ス ホ ン ト フ ォ ー マ ッ ト ) の し ツ ダ リウ ダグ 
モー ド を 設定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


段落 に 関連 づけ る タブ スト ッ プ を 指定 で きま す 。 タ ブス 
トッ プ の 種類 は 、flash.text.engine.TabAlignment ク ラ 
ス で 定義 され て いる 4 種類 で す 。 

CENTER : タブ で 区 切っ た テキ スト の 中 心 を タブ スト ッ 
プ に 配置 し ます 。 

DECIMAL : タブ で 区 切っ た テキ スト の 整列 トー クン を 
タブ スト ッ プ に 配置 し ます 。 

END : タブ で 区 切っ た テキ スト の 終了 を タブ スト ッ プ に 
配置 し ます 。 

START : タブ で 区 切っ た テキ スト の 開始 を タブ スト ッ プ 
に 配置 し ます 。 

タブ スト ッ プ 種類 と タブ 位置 の 情報 を 持つ flash.text 
engine.TabStop オ ブ ジ ェクト 配列 を この tabStops プ ロ 
パテ ィ に 設定 で きま す 。 


Stait cernter decimal end 
1 あ も 流 上 
1 2 あい 23 456 AB 
123 あい う 123456.7890 ABC 





も ーー ん 
TLF エレ メン ト の スタ イル 設定 を 行う 


各 FlowElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


段落 内 の 行 揃え を | LextA11gn : * コン テ ナ を 基準 と し た 段落 内 の 行 揃え を 設定 で きま す 。 
取得 / 設 定 する flashx.textLayout.formats.TextAlign.LEFT : 
左端 揃え を 指定 し ます 。 
flashx.textLayout.formats.TextAlign.RIGHT : 
石 端 揃 え を 指定 し ます 。 
flashx.textLayout.formats.TextAlign.CENTER : 
コン テ ナ 内 で の 中 央 揃え を 指定 し ます 。 
flashx.textLayout.formats.TextAlign.JUSTIFY : 
コン テ ナ ス ペー ス を 埋め る よう に 、 テ キス ト を 行内 に 均 
等 配置 する こと を 指定 し ます 。 
flashx.textLayout.formats.TextAlign.START : 
始 端 揃え を 指定 し ます - テキ スト は 、 書 き 込 み 順 と 一 致 
する よう に 揃え られ ます 。 
flashx.textLayout.formats.TextAlign.END : 
終端 揃え を 指定 し ます 。 テ キス ト は 書き 込み 順 と は 反対 
か ら 揃 えら れ ま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


テキ スト の アル フ | textA1pha : * テキ スト の アル ファ (透明 ) 値 を 0 1 の 数 値 で 制御 で きま 
ァ 値 を 取得 / 設 定 す 。 
する flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


テキ スト の アシ ンダ テキ スト の アン ダー ライ ン 装 飾 を 指定 で きま す 。 
ー ラ イン 装飾 を 取 flashx.textLayout.formats.TextDecoration.NONE : 
得 / 設 定 する 装飾 は 行い ませ ん 。 

親 の 値 を 継承 し ます 。 


flashx.textLayout.formats.TextDecoration.UNDER 
テキ スト の イン デ | LextTndent :* 
ント を 取得 / 設 定 
する 

デフ ォ ル ト 値 : undefined 


LINE : テキ スト に アン ダー ライ ン を 引き ます 。 

テキ スト の 均等 配 | CexEJuUS モ 1 上 Y:* テキ スト の 均等 配置 オプ ショ ン を 指定 で きま す 。 

置 オ プシ ョ ン を 取 flashx.textLayout.formats.TextJustify.INTER_ 

得 / 設 定 する WORD : 空白 文字 に スペ ー ス を 追加 し て 均等 配置 を 実行 
する こと を 指定 し ます 。 
flashx.textLayout.formats.TextUustify.DISTRIBUTE : 
空 日 文字 と 個々 の 文字 間 の 両方 に スペ ー ス を 追加 し て 均 
等 配置 を 実行 する こと を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 













textDecorat ュ on 
< 天 


























flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 







段落 の 1 行 目 の イン デン ト を -1000 て 1000 の ピク セル 値 
で 指定 で きま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
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6- 1 
Text Layout Framework (TLF) 


名 FlovElement ク ラス の 主 な プロ パテ ィ ( 続 き ) 


テキ スト の 長 さ を | textLengh : 1nt [読み 取り 専用 ] オブ ジェ クト が 保持 する テキ スト の 合計 
『 取得 する の 長 さ を 取得 で きま す 。 


テキ スト の 回 転 を | LextRotat1on :* テキ スト の 回 転 角度 を 指定 で きま す 。 

取得 / 設 定 する flash.text.engine.TextRotation.ROTATE 0 : 
回 転 は 指定 し ませ ん 。 
flash.text.engine.TextRotation.ROTATE_180 : 
180 度 回 転 を 指定 し ます 。 
flash.text.engine.TextRotation.ROTATE_270 : 
時 計 回 り の 270 度 回 転 を 指定 し ます 。 
flash.text.engine.TextRotation.ROTATE_90 : 
時 計 回 り の 90 度 回 転 を 指定 し ます 。 
flash.text.engine.TextRotation.AUTO : 
文字 の Unicode プ ロ パ ティ に 従っ て 、 全 角 文 字 に 対し て 

_6 | の み 、 反 時 計 回 り の 90 度 回 転 を 指定 し ます 。 

デフ ォ ル ト 値 : undefined 


文字 の 左 / 右 側 の | trackingLeft:* 各 文 字 の 左 / 右 側 に た トラッキング (手動 カー ニン グ ) を ど 
トラ ッ キ ング を 適 | trackingRight:* | れ だ け 適 用 する か を 、 -1000 て 1000 の ピク セル 単位 また 
用 する は 、-1000 一 1000% の fontSize に 対す る パー セン ト 値 で 
指定 で きま す 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 


文字 の 大 文字 / 小 文 | EypographicCase | テキ スト に 使用 され る 文字 の 大 文字 / 小 文字 区 別 の タイ プ 

字 区 別 の タイ プ を | :* を 表し ます 。 

取得 / 設 定 する flashx.textLayout.formats.TLFTypographicCase. 
DEFAULT : デフ ォ ル ト の 大 文字 と 小文字 の 区 別 を 指定 
し ます 。 特別 な 機能 は 適用 され ませ ん 。 
flashx.textLayout.formats.TLFTypographicCase. 
CAPS_ TO_SMALL CAPS : 出力 時 に 大 文字 で スモ ー ル 
キャ ッ プ 文字 を 使用 する よう 指定 し ます 。 
flashx.textLayout.formats.TLFTypographicCase. 
UPPERCASE : 出力 時 に すべ て の 文字 で 大 文字 を 使用 す 
る よう 指定 し ます 。 
flashx.textLayout.formats.TLFTypographicCase. 
LOWERCASE : 出力 時 に すべ て の 文字 で 小文字 を 使用 
する よう 指定 し ます 。 
flashx.textLayout.formats.TLFTypographicCase. 
LOWERCASE_TO_SMALL_CAPS : すべ て の 小文字 を 
大 文字 に 変換 し 、 変 換 で 変更 され た 文字 に の み ス モー ル 
キャ ッ プ ス を 適用 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
有 親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 
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6-1-4 
TLF エ レ メ ン ト の スタ イル 設定 を 行う 


待 FlovvElement ク ラス の 主 な プロ バテ ィ ( 続 き ) 


垂直 行 揃え と 均等 | yertica1A11gn:* | 垂直 方 向 の 行 揃え また は 均等 配置 を 表し ます 。 

配置 を 取得 / 設 定 flashx.textLayout.formats.VerticalAlign.TOP : 
する フレ ー ム の 上 端 に 揃え る こと を 指定 し ます 。 
flashx.textLayout.formats.VerticalAlign.MIDDLE : 
フレ ー ム の 中 央 に 揃え る こと を 指定 し ます 。 
flashx.textLayout.formats.VerticalAlign.BOTTOM : 
フレ ー ム の 下端 に 揃え る こと を 指定 し ます 。 
flashx.textLayout.formats.VerticalAlign.JUSTIFY : 
フレ ー ム 内 で の 垂直 方 向 の 行 の 均等 配置 を 指定 し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 

デフ ォ ル ト 値 : undefined 


テキ スト を TextFlow に イン ボート する 際 、 空 白 を 圧縮 ま 
た は 保持 する 指示 を 行い ます 。 
flashx.textLayout.formats.WhiteSpaceCollapse. 
PRESERVE : テキ スト の イン ボ ポート 時 に 空白 文字 を 維持 
し ます 。 
flashx.textLayout.formats.WhiteSpaceCollapse. 
COLLAPSE : テキ スト の イン ポー ト 時 に 空白 文字 を 圧縮 
し ます 。 
flashx.textLayout.formats.FormatValue.INHERIT : 
親 の 値 を 継承 し ます 。 
デフ ォ ル ト 値 : undefined 

































イン ポー ト 時 の 空 | whiteSpace 
白 文 字 の 処理 を 指 | Co11apse:* 
定 する 












筆 FlowElement ク ラス の 主 な メソ ッ ド 


メソ ッ ド の 概要 


styleProp に より 指定 され た スタ イル を この 
FlowElement オ ブ プ ジ ェクト か ら ク リア し て 
値 を undefined に し ます 。 


すべ て の 子 を 含む FlowElement オ ブ ジ ェ ク 
ト の コピ ー を 作成 し て 新しい オブ ジェ クト 
と し て 返し ます 。 

relativeStart : コピ ー 対 象 の 最初 の 文字 の 
相対 テキ スト 位置 。-1 は 、 エ レ メ ン ト の 終 
わり を 表し ます 。 

relativeEnd : コピ ー 対 象 の 最後 の 文字 の 
相対 テキ スト 位置 


テキ スト フロ ー 階 層 内 の 次 / 前 の 同じ タイ プ 

















スタ イル を クリ ア す る clearSty1e ( 
8 上 16GP エ Op : S 上 エ ュ nd 


) : YO1d 
















オブ ジェ クト の コピ ー を 作成 
する ( 子 を 含む ) 











deepCopy ( 
relaL1VeS ヒ ar : 
1n 革 = 0, 
rela 上 1VeEmnd : 1nE 
= -1 

: FlowE1emen 























同じ タイ プ の 次 / 前 の FlowEle | getNextSib1 ing () 








ment オ ブ プ ジ ェ クト を 取得 する | :F1owE1ement の FlowElement オ プ ジ ェ クト (兄弟 ) を 取得 
de 上 Preyiou8g し ます 。 
Sib1ing ( ) 






: FlowE] emen 
















関連 づけ られ て いる Paragra 
phElement オ ブ ジ ェクト を 取 
得する 


この エレ メン ト に 関連 づけ られ て いる Para 
graphElement オ ブ ジ ェクト を 取得 し ます 。 







qetParaqraph ( ) 





ParadraphE1emen 
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6- 1 
Text Layout Framework (TLF) 


息 FlowElement ク ラス の 主 な メソ ッ ド (続き ) 


指定 し た スタ イル の 値 を 取得 | getSty1e( styleProp で 指定 し た スタ イル の 値 を 取得 し 
する ty1eProp : St 上 rind | ます 。 


) : * 



































フロ ー エ レ メ ン ト 内 の 指定 され た テキ スト 
男 囲 を 取得 し ます 。 

relativeStart : FlowElement の 開始 位置 に 
対し て 相対 的 な 開始 位置 で す 。 

relativeEnd : FlowElement の 開始 位置 に 
対し て 相対 的 な 、 テ キス ト 範 囲 の 終了 位置 
で す 。-1 は 、 エレ メン ト の 終わ り を 表し ます 。 
paragraphSeparator : 段落 間 に 挿 入 さ れ 
る 文字 を 指定 で きま す 。 


エレ メン ト の ルー ト TextFlow オ ブ ジ ェクト 


エレ メン ト 内 の テキ スト 範囲 
を 取得 する 


qetTex ( 
re aa 上 1TVeGS ヒ ar : 
1n ロ も = 0, 

re at1VeEmnd : 1n 
= -1, 

paradraph 
SeparatOr : S 上 in 


) : Strinqd 



































ルー ト TextFlow オ ブ ジ ェクト | qetTextF1ow () 


















を 取得 する : FlaShx . を 取得 で きま す 。 
ext 上 LayYOuU . 
elemen8 : 
TextF1Ow 













setStyle ( 
8 上 1eP エ OD : 
Str1nmd , 
mewValUuG :* 
) : Vo1d 


スタ イル を 適用 する styleProp で 指定 し た スタ イル 値 を 、new 


Value で 指定 する 値 に 設定 し ます 。 





































子 を 含ま な い FlowElement オ ブ ジ ェクト の 
コピ ー を 作成 し て 新しい オブ ジェ クト と し 
て 返し ます 。 

relativeStart : コピ ー 対 象 の 最初 の 文字 の 
相対 テキ スト 位置 。 -1 は 、 エ レ メ ン ト の 終 
わり を 表し ます 。 

relativeEnd : コピ ー 対 象 の 最後 の 文字 の 
相対 テキ スト 位置 


指定 され た 位置 で オブ ジェ クト を 分 割 し 、 そ 
の 位置 か ら 始ま る 新しい FlowElement オ ブ 
ジェ クト を 返し ます 。 

relativePosition : 元 の オブ ジェ クト の コン 
テン ツ を 分 割 す る 位置 で す 。 最初 の 位置 は 0 
全 す 。 


オブ ジェ クト の コピ ー を 作成 
する ( 子 を 含ま な い ) 


sha11owCopy ( 
re a ヒ 1VeGS キ ar : 

1 セ = 0。 

re] at 上 1veEnd : in 
= 

) : Fl1owE1ement 











Sp1 1tA 革 Pogi 七 1On ( 
re la 上 1VePO81 ヒ 
1Om : 1n ヒ 

) : Fl1owE]1ement 


オブ ジェ クト を 分 割 する 













(ここ が ら %SPDd 


な ーー 
TLF エレ メン ト の スタ イル 設定 を 行 


9. 計 


シス テム 便 発 者 や 、 プロ グラ ミン グ ま で 行う 一 部 の 高度 な パソ コン ユー ザ で し か 作る こと が 難し か っ た デス クト ッ プ アプ リ 
ケー ショ ーー 


ae プリ ケー ショ ン は 動画 アニ 
明 テー タベース エ ソ ク ン を 使用 し て 職 大 な テー タ を 高速 に 処理 する こと が で きま す 。 


ア ず ・ 
# 


上 (ここ から shan2) 


ーション や ビデオ の 再生 を 行い 、 イ ンタ ーネット に アク セ ゼス し 、 組 み 込ま れ た 


| dobe AIR (Adobe Integrated Runtime ア ド ビ エア ー) は 、 個 人 
| の 趣味 や 実用 を 目的 と し た アプ リケーション だ け b ト て 


業務 レベ ル に 


『 ケー ジョ ン 


十分 耐え う る 機能 と 信頼 性 を 併せ 持つ ア 
を 作成 する た め の 環 境 と 開発 方 法 を 提供 - 


リ 
を る 4 


Fn cao 





文字 名 書 フォ ント サイ ズ 14 


| 小塚 ゴ シッ ク P "| 


ーーーーーーーー 


FlowElement に よる 書式 変更 ※ 実 行 に は FlashCS5 が 必要 


1mDor キ 上 
1mDOr キ t 
1mDOr キ 
1mDpOr 
1mDOr 
1mDOr 
1mDOr 
1mDOr 
1mDOr ヒ 
1mDOr キ 
1mDOr キ 上 


1mDpOr 


JHLFFlowelementSample.fla 


F]ash.disp1ay . SD エ 1e: 
Flashx . 
Flashx . 
Flashx . 
Flashx . 
Flashx . 
Flashx . 
Flashx . 


f]ash.everntg .MOu8eEEVen 七 


textLayout .e1ements . TextF1Ow: 


textTLiayout . Formats . TextLayOutFOormma : 
textLiayout . container .Conta1nerCOontro11e〒: 
textLiayout . compose . StandardF1OwCOmDOSe : 
ex 上 TayOu . COnVeGr81On . GE 上 COnVG エ ヒ G エ 
textLayout .e1ements .F1owElement : 
textLiayout .e1ements .F1owLeafElement : 
Flashx .textLiayout . Formasg . TextLayOutFOrma : 
F] .contro1 gs . Rad1OBu ヒ 上 OnGTOUDP : 


Ff]ash .text . end1ne .GrOupElemen : 


yar Fl]owData : TextF1OW: 


var fF]owFormat : Text 上 ayOut 上 FOrma 七 : 


var fF]owForma 上 2 : Text 上 ayOutFOrma : 
/ / 表 示 コ ン テ ナ オブ ジェ クト と サイ ズ 


yar textConta1ner : SD エ ユ 6: 


var containerHe1qdht : NumDe エ = 


yar containerW1dEh : NumDer = 


500: 
780: 
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6- 1 
Text Layout Framework (TLF) 


Var SDanGrOUD : Rad1OBut 上 OnGrOUD : 
//TLF マ ー ク アッ プ に よる テキ スト デー タ 
Var 上 1FMarKUup : XML」 = 





③⑪ 
<TextF1OW xmlng= "htp : / /ns . adobe . com/textLayout/2008"> 
<1md SOUFCe="1mage8/ SummerTmaqge2 .GTF" width="30" he1qght="50『"/> 
<d1V FontS1ze="12"> (ここ か ら sgpan1 ) < /d1Y> 
<p St 上 yleName= "styl1e1"> 
<Span 1d="gpan1"> シ ステ ム 開 発 者 や 、 プ ログ ラミ ング まで 行う 一 部 の 高度 な パソ コン ユー ザ で し か 作る 
こと が 難し か つた デス クト ッ プ アプ リケーション が 簡単 に 作れ る 時 代 に な り ま し た 。 
<b 了 / > 
し か も その アプ リケーション は 動画 アニ メー ショ ン や ビデ オ の 再生 を 行い 、 イ ンタ ーネット に アク セス し 、 組 み 込 
まれ た デー タベース エン ジン を 使用 し て 膨大 な デー タ を 高速 に 処理 する こと が で きま す 。 
</ SDan> 
</p> 
<1md SOurCe= "1mage8/ SummerTmage3 .GTF" width="30" height="50"/> 
<d1Y FontS1ze="12"> (ここ か ら span2 ) < /d1Y> 
<p StyleName= "st 上 yle2" fontSize="12"> 
<Span 1d="span2">Adobe ATR(Adobe Tntegrated Runtime ア ド ビ エア ー) は 、 個 人 の 趣 
味 や 実用 を 目的 と し た アプ リケーション だ け で な く 、 業 務 レ ベル に 十分 耐え うる 機能 と 信頼 性 を 併せ け 持つ アプ リ ケ 
ーション を 作成 する た め の 環 境 と 開発 方 法 を 提供 する イン フラ で す 。 
</ SDan> 
</p> 
</TextF]1 oOw> : 
Function ni ( ) :void 
( 
// テ キス ト を 表示 する オブ ジェ クト 
textConta1ner = new Sprite ( ) : 
textConta1ner.Xx = 10: 
textConta1ner.Y = 10: 
8tage . adQdChi1d( textContainer ) : 
/ / デ フォ ルト の 書式 を 設定 
FlOwFormat = new TextLiayoutFormat ( ) : 
F1owFormat . Co]or = Ox000000: 
F1owFormat .EontFamt1y = "小塚 ゴシック Pro R, ゴシック , 明 朝 ": 
F1OwFormat . FontSize = 14: 
//TextF1ow オ ブ ジ ェクト を 作成 し て 書式 を 適用 
Fl1owData = TextCOnVerEer . 1mDortTOF1Ow (上 1FMarkup , TextConverter.TEXT 
LAYOUT FORMAT) , 


F1owData .hostFormat = fF]owFormat : 


6-1-4 
TLF エレメント の スタ イル 設定 を 行う 


//TextF1ow を 表示 する た め の コ ン ポ ボー ザー を 設定 

Var Conr : Conta1nerContro]1er = new ContainerContro1] 1 er (textContain 
er , ContainerW1dth , ContainerHe1qh ) : 

FlowData .F1owCompoSer = new StandardF1owCompo8er() : : 

FlowData .fF1owComposer . addController( contr ): 

F]owData .F1owComposer . updateAl1Control11ers ( ) : 

/ / ボ タン の イベ ント バン ドラ 登録 

this .set btn.addEventListener (MouseEvent .CLTCK, setElement ): 
SDanGrTOUD = new Rad1OBu ヒ OnGrOUD ( " SDanGrOuD" ) : 

Span1 rad1O.drOUuD = SDanG エ OUD : 

Span2 rad1O.9rOUD = SDanGrOUD : 


) 1 


Function setE1lement (event : MouseEven ) : Vo1Q 
1F (SDanGrOUD . SG1eGCt 上 1On == Tnul] ) 
GUuTT : 


) 


// TD を 指定 し て 1owE1ement オ ブ ジ ェクト を 取得 

var element :FlowElement = FlowData .gdetElementByTD ( SDanGrouD . 
Se] ec 上 上 ion . abe ) : 一 一 ーーーーーーーーーーーーーー ーーーーーーーーーーーーーーーーーーーー (3) 
/ /F1owE1ement の 書式 を 設定 

element .color = colorPioker . SelectedCo1 or : 

element .fontFam11y = fontCombo . selectedTtem . data : 

elemen .fontS1ze = 81zeNumer1CSteDDer .Ya1UG : 

/ / 表示 を 更新 する 

F]owData .f1owComposer .updateA11Contro11erg ( ) : ーーーーーーーーーーー④ 


) 


1n1 七 ( ) : 


① か ら TLF マ ー ク アッ プ デ ー タ を 作成 し て いま す 。 マ ー ク アッ プ デ ー タ の 読み 込み と 表示 ロ 
ジッ ク は 、 著 呈 護 灸 と 同様 で す 。② の 関数 で TextFlow オ ブ ジ ェクト 内 の FlowElement オ ブ ジ ェ 
クト を 取得 し て 書式 を 設定 し て いま す 。3⑬) で TextFlow ク ラス の getElementByID() メ ソ ッ ド 
で エレ メン ト が 持つ ID を 指定 し て 、FlowElement オ ブ ジ ェクト を 取得 し ます 。 取 得 し た オブ 
ジェ クト に 対し て 行う 設定 は その まま 反映 され ます が 、 表示 を 更新 する た め に 、(④ の 、TextFlow 
オブ ジェ クト が 参照 する FlowComposer オ ブ ジ ェクト が 提供 する updateAlIControllers() を 
呼び 出し 、 表 示 コ ント ロー ラ を 更新 する 必要 が あり ます 。 
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7 - 1] ステ ー ジ と タイ ムラ イン 
Stage オブ ジェ クト を 使う 





PART 
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ステ ー ジ と 呼ば れる Flash の メイ ン 描 画 領域 は Stage ク ラス の オブ ジェ クト で 、 ア プリ ケー 

ショ ン に 1 つ だ け 存 在 する 最上 位 コ ン テ ナ で す 。 Stage ク ラス の プロ パテ ィ と メソ ッ ド に より 、 

ActionScript で ステ ー ジ サイ ズ や フレ ー ム レー ト の 制御 な どの 操作 が で きま す 。Stage オ ブ 
ジェ クト に アク セス する に は 、DisplayObject オ ブ ジ ェクト の stage プ ロバ ティ を 使用 し ます 。 

DisplayObject ク ラス は MovieClip を 含 お すべ て の 表示 オブ ジェ クト の スー パー クラ ス な の で 、 
それ ぞ れ の 表示 オブ ジェ クト か ら stage プ ロ パ ティ で Stage オ ブ ジ ェクト に アク セス で きま す 。 

Flash オ ー サ リン グ 環 境 で は 、 ド キュ メン ト プ ロ パテ ィ ダ イア ログ で Stage オ ブ ジ ェクト に 関す 

る いく つか の 設定 を 行え ます 。 


サイ ズ を 合わ せる (8) : 
背景 色 ⑧⑥: 。 
フレ ー ム レー ド P) : 
ルー ラ 単 位 (R) : 2t ル 


| チ フ ォ ル ト に する MO | 





符 Stage クラ ス の 主 な プロ バテ ィ 概 要 


ステ ー ジ の 配置 位 | a11gn : Stringd Flash Player 上 の ステ ー ジ の 上 下 左右 配置 を 指定 し ます 。 
置 を 調整 する 


フル スク リー ン モ | disp1ayState : 標準 / フ ルス クリ ー ン モー ド の 切り 替え を 行い ます 。 
ー ド に する Srinq 


フレ ー ム レー ト の ステ ー ジ の フレ ー ム レー ト を 取得 / 設 定 し ます 。 
取得 / 変 更 す る 

レン ダリ ング 品質 
を 取得 / 変 更 す る 












FameRate : 
NumDer 











グラ フィ ッ ク と ビッ トマ ッ プ の レン ダリ ング 品質 レベ ル 
を 取得 / 変 更 し ます 。 次 の 値 を 使用 で きま す 。 
StageQuality.LOW : 低い レン ダリ ング 品質 。 グ ラフ ィ 
ッ ク は アン チエ イリ アス 処理 され ず 、 ビ ッ ト マ ッ プ は ス 
ムー ジン グ さ れ ま せん 。 

StageQuality.MEDIUM : 普通 の レン ダリ ング 品質 。 グ 
ラフ ィ ッ ク は 2 x 2 クビ ピク セル グリ ッ ド を 使用 し て アン チエ 
イリ アス 処理 され 、 ビ ッ ト マ ッ プ の スム ー ジ ング は 
Bitmap.smoothing 設 定 に 応じ て 処理 され ます 。 
StageQuality.HIGH : 高い レン ダリ ング 品質 。 グ ラフ ィ 
ッ ク は 4 x 4 ピク セル グリ ッ ド を 使用 し て アン チエ イリ ア 
ス 処 理 さ れ 、 ビ ッ ト マ ッ プ の スム ー ジ ング は Bitmap.smo 
othing 設 定 に 応じ て 処理 され ます 。 
StageQuality.BEST : 非常 に 高い レン ダリ ング 品 貸 。 


qua1 1ty : S キ 上 了 エ ュ nd 





















7-1-1 
Stage オ ブ ジ ェクト を 使う 


に Stage ク ラス の 主 な プロ バテ ィ 概 要 (続き ) 




























拡大 / 縮 小 時 の 動作 | sca1eMode : Flash Player と ステ ー ジ の サイ ズ が 異な る 場合 に どの よ 
(モー ド ) を 取得 / 変 | String うに ステ ー ジ サイ ズ を 調整 する か を 指定 し ます 。 
更 する StageScaleMode 








ステ ー ジ の サイ ズ | stageHeight : int | 現在 の ステ ー ジ の 高 さ / 幅 を 取得 で きま す 。 
を 取得 する staqeW1dth : in 
筆 Stage クラ ス の 主 な イベ ント 


Fu11Screen Stadge オ ブ ジ ェクト が フル スク リー ン モ ー ド に 設定 
(定数 FulIScreenEvent. | され た と き 、 お よび フル スク リー ン モ ー ド か ら 解 除 
FULL_ SCREEN) され た と き 送 出さ れ ま す 。 


Flash Player の 表示 領域 サイ ズ が 変更 され る と 送出 
され ます 。 つ まり ウィ ンド ウ の サイ ズ が 変わ っ た と 
き に 送出 され ます 。 た だ し 、Stage オ ブ ジ ェクト の 
scaleMode プ 口 パテ イィ が StageScaleMode. 
NO_SCALE に 設定 し て いる と きのみ 送出 され ます 。 
















フル スク リー ン / 標 準 
モー ド 切 り 替 え 















GS81 と G 


(定数 Event.RESIZE) 


表示 領域 の サイ ズ が 
変更 









AMPLE ピロ ロビ ニニ 


Stage オ ブ ジ ェクト の イベ ント を 確認 する StageSampleAfla 
//Stage イ ンス タン ス に は 、stage と いう 記述 で アク セス で きま す 。 
Stage . SCaleMode = StageSoa1eMode .NO_ SCALE : 
8tage . addEventL1istener ( Event .ACTTVATE , stageEventHand1er ): 
Stage . addEventL1istener ( Event .RESTZE, stageEventHand1er ): 
funct1on stageEventHand1er( event :Event ) :void { 
trace( event .type + " イベ ント が 発生 し まし た 。 " + 
"現在 の ステ ー ジ サイ ズ は 幅 =" + stage . stageWidth + 
", 高 さ =" + gtage . stageHe1ight + "で す 。" ): 


Stage ク ラス の activate イ ベン ト と resize イ ベン ト を ハン ドル し て ステ ー ジ の サイ ズ を 調べ 
て いま す 。 共通 の ハン ドラ 関数 を 使用 し て いま す が 、 イ ベン ト の 種類 は event.type プ ロ パ ティ 
で 取得 で きま す 。 
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実行 時 に フレ ー ム レー ト を 変更 する 





PART 
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Stage ク ラス の frameRate プ ロ パ ティ で 現在 の フレ ー ム レー ト を 取得 で きま す 。 この 値 を 変 
更 す る と 、 ム ー ビ ー の フレ ー ム レー ト を 変更 する こと が で きま す 。 フ レー ムレ ー ト は 0.01 一 
1000 の 範囲 で 設定 可能 で す 。 


算 Stage ク ラス の フレ ー ム レー ト に 関す る プロ バテ ィ 


: | 使用 可能 な フォ ント の リス ト を 配列 で 返し ます 。 パ ラメ ー タ enumerateDeviceFontS 
NumDer は 次 の よう に 使用 で きま す 。 

true : デバ イス フォ ント と 埋め 込み フォ ント の リス ト を 作成 し ます 。 
false (デフ ォ ル ト ) : 埋め 込み フォ ント の リス ト の み を 作成 し ます 。 






















ファ イル (F) 表示 (y) 制御 ( 〇 O デバ ッ グ (D) 


ーー 


フレ ー ム レー ト を 実行 時 に 変更 する StageSampleB.fla 


FrameRate n8. addEyventTLiistener ( Event .CHANGE, changeFrameRate ): 
function changeFrameRate (event : Event ) : Vo1d {( 
/ / ス テー ジ の フレ ー ム レー ト を 変更 


8 も age 、ErameRate = FrameRate ng8.valuej 一 一 一 ーーーーーーーー デ ーーー デン 


① で Stage オ ブ ジ ェクト の frameRate プ ロバ パテ ィ に 値 を 設定 し 、 フ レー ムレ ー ト を 変更 し て 
いま す 。 変更 する と 埋め 込み ビデ オ の 再生 レー ト を 変更 する 効果 が 得 ら れ ま す 。 


ステ ー ジ の 拡大 / 縮小 モ ー ド を 
ビオ 束 有 まっ 


Stage ク ラス の scaleMode プ ロバ ティ で 、Flash Player の 表示 領域 (ウィ ンド ウ ) の 大 き さ に 
より 、 ア プリ ケー ショ ン の ステ ー ジ が どの よう に 変化 (拡大 / 縮 小 ) する か を 調整 で を ます 。 
scaleMode プ ロバ ティ の 値 は StageScaleMode ク ラス に 定数 と し て 提供 され ます 。 





特 Stage ク ラス の 拡大 / 縮 小 モ ー ド に 関す る プロ パテ ィ 


gCaleMode : Flash Player の 表示 領域 に 対し て ステ ー ジ が どの よう に 拡大 / 縮 小 す る か を 決定 し 
Str1nq ます 。StageScaleMode ク ラス の 定数 プロ パテ ィ 値 が 使用 で きま す 。 


















逢 StageScaleMode クラ ス の 定数 プロ バ パティ 


Stage クラ ス の 拡大 / 縮 小 モ ー ド 


アプ リケーション の ステ ー ジ の 大 き さ は 固定 に な り 、 ウ ィ ン ド ウ の サイ ズ 変 更に 
避 約 ご れ ま せん 。 


ステ ー ジ の 縦横 比 は 維持 され ず 、 ウ ィ ン ド ウ の サイ ズ に フィ ッ ト し ます 。 


ステ ー ジ の 縦横 比 が 維持 され た まま 、 で きる だ け ウ ィ ン ド ウ の サイ ズ に フィ ッ ト 
し よう と し ます 。 そ の た め 、 ス テー ジ 以 外 の 余白 部 分 が で きる こと が あり ます 。 


ステ ー ジ の 縦横 比 が 維持 され た まま 、 ウ ィ ン ド ウ の サイ ズ い っ ぱい に 表示 され ま 
す 。 そ の た め 、 ス テー ジ の 一 部 が トリ ミン グ さ れる 場合 が あり ます 。 











s 訓 画 コ 粒 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


の CD 人 OCR 4 SOFCKS か で 
ファ イル (F) 表示 (y) 号 御 (CO デバ ッ グ 





StaaeScaleMode .SHOW ALL 


WStaqeScatLeMode .EXACT FIT 


StageScaleMode .NO BDRDER 
ーー ペー ーーae 上 


^ SraGeScateMode .NO.SCALE 
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ゲー こ 1 
ステ ー ジ と タイ ムラ イン 


ステ ー ジ の 拡大 / 縮 小 モ ー ド を 確認 する サン プル で す 。 こ れ が ステ ー ジ の オリ ジ ナ ル サ イ ズ 
(StageScaleMode.NO_SCALE) で す 。 ウィン ドウ サイ ズ に より 、 ス テー ジ が Flash Player 表 
示 領 域 よ り 小 さい た め 、 上 下 左 右 に 才 折 が で き て いま す 。 


PART 
mm mm Rm 
ステ ー ジ の 拡大 / 縮 小 モ ー ド を 確認 する StageSampleC.fla 
/ / ラ ジオ ボタ ン が 押さ れ た と き の イ ベン トバ ハン ドラ 登録 
this .show a11 rb.addEventListener( MouseEvent .CLTCK, ohangeSoaleMode ): 
this .exact Fit rb.addEventLigstener ( MouseEvent .ChTCK, changeSoal1eMode 
) : 
this .no border rb.addEventLigstener( MouseEvent .ChTCK, changeScaleMode 
) : 
this.no sca1e rb.addEventListener( MouseEvent .ChTCK, changeScaleMode ): 
に / / ラ ジオ ボタ ン が 押さ れ た と き の イ ベン トバ ハン ドラ 


Function changeScaleMode (event : Event ) :vo1d { 
/* scaleMode を 設定 
(ラジ オ ボ タ ン の va1ue プ ロ パ ティ に sca1eMode プ ロ パ ティ 用 の 値 が 設定 され て いま す ) */ 


8Eaqe . 8CaleMode = @Ve れ も. も arqdet .VaLue: --ーーーーーーーーーーーーーーーーーー ゆ 


や で scaleMode を 指定 し て いま す 。 ラ ジオ ボタ ン の value プ ロ パ ティ に 各 scaleMode の 値 
が 設定 され て いる の で 、 そ の まま 割り 当て を 行っ て いま す 。 


田 StageScaleMode.SHOW_ALL 


ファ イル (E) 表示 (Y) 制御 (CO デバ ッ グ (D) 








> StaqeScateMode.SHOW_ ALL 


W StaqeScatleMode .EXACT FII 


N StaqeScaleMode .NO BURDER 


「。 


EE 


* StaaeScaleMode.NO_SCALE 


17Z2 


プー-1-3 
ステ ー ジ の 拡大 / 縮 小 モ ー ド を 変更 する 


ステ ー ジ の 縦横 比 は 固定 で ウィ ンド ウ に フィ ッ ト さ せま す 。 上 下 に フィ ッ ト し て 左右 に 余白 
が で き て いま す 。 


一 StageScaleMode.EXACT FT _ 。 0 0 


ン stageSampleC sf SSR RS 陸 Pe Fo ッ ・ 
ファ イル (F) 表示 Cy) 制御 ( 〇 デバ ッ グ (D) 





BN StaqgeScaLeMode .SHOW ALL 


S StaqeSca teMode . EXACT FIT 


WStageScaleMode.NO NRDER 
ーーーーーーー _- 


n。、 


。・ っ taqeSca LeMode .NO SCALE 





ステ ー ジ の 縦横 比 を 無視 し て 完全 に ウィ ンド ウサ イズ に フィ ッ ト し ます 。 


一 StageScaleMode.NO -PORDER 


stageSampleC sw 32 mookeu 陽 汗 
ファ イル (FE) 表示 (Y) 司 御 (CO デバ ッ グ (D) 





委 StaqeScaLeMode .SHOW ALL 


5 StaqeSca teMode . EXACT FITT 


を (に に (に Je に 導い 0 願い りり コ に 
MAS コー イ 


2 
に 


。 っ taqeSca LeMode .NO_SCALE 





ステ ー ジ の 魚 横 比 は 固定 で 奈 白 が な いよ うに ウィ ンド ウ の サイ ズ い っ ぱい に 表示 され 、 必 要 
な 場合 トリ ミン グ さ れ ま す 。 
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フル スク リー ン モ ー ド を 使う 
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Stage ク ラス の displayState プ ロ パ ティ で 、 フ ルス クリ ー ン モー ド と ノー マル モー ド を 切り 
替え ます 。Flash CS4/CS5 で は 、 パ ブリ ッシュ 設定 -HTML の 「 テ ンプ レー ト 」 で [Flash の み - 
フル スク リー ン サ ポー ト 」 を 選択 する こと に より 、HTML に フル スク リー ン モ ー ド を 許可 する 
た め の パ ラメ ー タ が 追加 ご れ 、 オ ー サ リン グ 時 に も フル スク リー ン の 確認 が 行え ます 。「 ム ー ビ 
ー プ レビ ュー」 で は フル スク リー ン モ ー ド へ の 切り 替え は で きま せん 。 ま た 、 フ ルズ ス クリーン 
モー ド で は 透明 背景 は サポ ボー ト さ れ ま せん 。 


垂 Stage ク ラス の フル スク リー ン モ ー ド に 関す る プロ バテ ィ 


プロ パテ ィ プロ パテ ィ の 詳細 


31 splaySt{ Flash Player を ユー ザ 画 面 全体 に 拡張 する フル スク リー ン モ ー ド に 設定 を 行う 
St 上 1nd か 、 標 準 モ ー ド で 表示 する か を 決定 し ます 。StageDisplayState ク ラス の 定数 
プロ パテ ィ 値 が 使用 で きま す 。 







! 
が 

















皿 StageDisplayState クラ ス の 定数 プロ バテ ィ 


FULL SCREEN フル スク リー ン モ ー ド を 示し ます 。 


フル スク リー ン モ ー ド で キー ボー ド 操 作 が 有効 で ある こと を 
示し ます 。 


FULL_ SCREEN_INTERACTIVE 標準 モー ド を 示し ます 。 
(AIR の み ) 


徐 フル スク リー ン モ ー ド を 有効 に する た め の HTML バ ラメ ー タ 
















NORMAL 





<noscrip や 内 の param タ グ <param name="allowFulIScreen" value="true" /> 





<noScrip や 内 の embed タ グ <embed src="example.swf" allowFulIIScreen="true" .… > 


AC FL RunContent 関 数 の パラ メー タ | AC_FL RunContent( .… allowFulScreen', true, .… ) 


※ こ れ ら の パラ メー タ は パブ リッ シュ 設定 -HTML の 「 テ ンプ レー ト 」 で [Flash の み - フル スク リ 
ー ン サポ ー ト ] を 選択 し て パブ リッ シュ する こと で 設定 され ます 。 





田 フル スク リー ン モ ー ド 


7-1-4 
フル スク リー ン モ ー ド を 使う 











Flash Player が 表示 する 、 ESC キ ー で も フル スク リー ン 
モー ド を 終了 で きる こと を 知ら せる メッ セー ジ 
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ゲー# 
ステ ー ジ と タイ ムラ イン 


= 前 コ 疾 中 mp】 ヨ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


フル スク リー ン モ ー ド と 標準 モー ド を 切り 替え る StageSampieD.fla 
// テ キス ト に イベ ント ハン ドラ を 登録 
text txt .addEventListener( MouseEvent .CLTCK, Fu11Screen ): 
// フ ルス クリ ー ン と ノー マル モー ド を 切り 替え る 関数 
Function fu118creen ( event :MouseEven ) :vo1d 1 
Switch ( stage .disp1ayState ) { 
case StaqgeDisplayState . FULL SCREEN : 
/ / す で に フル スク リー ン の と き は ノー マル モー ド へ 
staqe .d1splayState = StaqgeDisplayState . NORMAL, : 一 一 ーーーーーーーーーー-(① 
text て xt .text = "クリ ッ ク し て フル スク リー ン モ ー ド へ *: 
break : 
ca8e StageDisplayStae . NORMAL : 
/ メ ノー マル モー ド の と き は ルズ ス グリーン シンセ で ド ペ 


stage .d1isplayState = StageDisp1ayState .FULL SCREEN: 一 ーーーーーー- ② 
tex 上 て xE. も texE = "フル スク リー ン モ ー ド で す (クリ ッ ク し て 戻り ます ) 『 : 
breaK : 


text_ txt と いう テキ スト を クリ ッ ク す る こと で フル スク リー ン モ ー ド に 切り 替え ます 。⑧⑫ で 
フル スク リー ン モ ー ド へ 、① で 標準 モー ド へ 切り 替え て いま す 。 フ ルス クリ ー ン モー ド に 切り 
替え る と 、Flash Player に より 、「 フ ルス クリ ー ン モー ド を 終了 する に は ESC キ ー を 押し ます 」 
と いう メッ セー ジ が 表示 され ます 。 


7 - 2 表示 オブ ジェ クト (DisplayObject) 
セン オン 人 HUENAU Ya を 


プ ジ ェ クト ) を 使う 





ActionScript1.0、2.0 で は 、 表 示 エ レ メ ン ト は すべ て MovieClip ク ラス に 含ま れ て いま し た 
が 、ActionScript3.0 で は 、Flash Player の ステ ー ジ に 表示 され る ビジ ュ ア ル エ レ メ ン ト は す 
べ て DisplayObjectt ク ラス を 基本 と する クラ ス と し て 作成 され て いま す 。 そ の た め 、 す べ て の 
表示 エレ メン ト に は 基本 的 な 共通 部 分 が あり ます 。 表示 オブ ジェ クト の 共通 する 使い 方 と し て 、 
イン スタ ンス を 作成 し た 後 、DisplayObjectContainer ク ラス の addChild() メ ソ ッ ド で 表示 リ 
スト に 追加 し ます 。DisplayObjectContainer ク ラス は Sprite や Stage ク ラス の 基本 クラ ス な 


の で 、 こ れ ら の イン スタ ンス で addChild() メ ソ ッ ド を 使用 で きま す 。DisplayObject ク ラス は 、 


画像 、 サ ウン ド 、 ム ー ビ ー の 読み 込み 時 に 情報 を 提供 する LoaderlInfor イ ンス タン ス へ の 参照 
も 提供 し ます 。 


理 DisplayObject ク ラス の 主 な プロ パテ ィ ( カ ラー と ブレ ンド モー ド 、 マ スク 関連 ) 概要 


削 明 度 ( ア ルフ ァ 値 ) を 取得 / 設 定 表示 オブ ジェ クト の アル ファ 透明 度 を 表し 
Number 


ます 。 取得 と 設定 が 可能 で す 。 
背景 オブ ジェ クト と 重なっ た 部 | blendMode : ョ 景 の 表示 オブ ジェ クト と 重なっ た 部 分 が 
分 の ブレ ンド モー ド St て 1ngd 


ある 場合 、 そ の 部 分 の 背景 と の ブレ ンド を 
設定 し ます 。 
BlendMode ク ラス の 定数 が 利用 で きま す 。 







































復 雑 な ベク ター 画像 の 表示 速度 
を 上 げ る 


CaCheAsB ュ map : 
Boolean 


ベク ター 画像 の ビッ トマ ッ プ イメ ー ジ を 
キャ ッシュ し て 表示 速度 を 向上 させ ます 。 


cacheAsBitmap と と も に 使用 し て 表示 速 
度 を 向上 させ る こと を 目的 と し ます 。 













ODaduUeGBaCK : drOU 







nQ : 
Ob] ect 










フィ ルター を 関連 づけ る flash.filters パ ッ ケ ー ジ に 定義 され た フィ ル 
ター クラ ス の イン スタ ンス に より 、 表 示 オ 
ブ ジ ェクト に フィ ルター 処理 を し ます 。 

Array オ プ ジ ェ クト を 指定 し て 、 複数 の フィ 


ルター を 積 的 に 適用 で きま す 。 


この プロ パテ ィ に 指定 し た オブ ジェ クト に 
より 、 表 示 オ ブ ジ ェクト は マス ク さ れ ま す 。 
設定 し た マス ク を 解除 する に は 、 こ の プロ 
パテ ィ に null を 指定 し ます 。 


表示 オブ ジェ クト に Transform オ ブ ジ ェ ク 
ト を 割り 当て て カラ ー 調 整 、 お よび マト リ 
ックス 変換 を 行い ます 。Transform ク ラス 
に これ ら の プロ パテ ィ を 設定 で きま す 。 


















ーー 
山 SK < 


DisplayOb]ec 


オブ ジェ クト に マス ク を か ける 

















オブ ジェ クト の カラ ー を 調整 /2 | transform : 
次 元 /3 次 元 マ トリ ックス 変換 を | Transform 
適用 
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7 プー2 
表示 オブ ジェ クト (DisplayObject) 


香 DisplayObject ク ラス の 主 な プロ パテ ィ ( 位 置 と サイ ズ 変 更 、 座 標 、 移 動 、 3D 関連 ) 


プロ バテ ィ の 本 


オブ ジェ クト の 高 さ / | He1ght: 表示 オブ ジェ クト の 高 さ 、 幅 を ピク セル 単位 で 表 
幅 を 取得 / 設 定 する し ます 。 














































マウ スポ イン タ の 座 | mouseX: 
標 を 取得 する mOuSeY : 
NumDer 


マウ スポ イン タ の x 座 標 お よび y 座 標 で す 。 単 位 は 
ピク セル で す 。 











親 の 表示 オブ ジェ ク | parent : 
トコ ン テ ナ 参照 を 取 | Disp1layOb]ect 
Conta1ner 


この 表示 オブ ジェ クト が 格納 され て いる Display 
ObjectContainer イ ンス タン ス を 表し ます 。 








自身 を 含む 表示 リス ト ツ リー 構造 の も っ と も 上 に 
ある 表示 オブ ジェ クト を 表し ます 。 表 示 リ スト に 
追加 され て いな い オ ブ ジ ェクト で は 、 こ の プロ パ 
ティ は null で す 。 ステ ー ジ を 参照 する 場合 は stage 
プロ パテ ィ を 使用 し ます 。 


この プロ パテ ィ に 値 を 設定 する こと で 、 表 示 オ プ 
ジェ クト を 回 転 で きま す 。 単位 は 「 度 」 で す 。 





ェクト コン テ ナ を 取 | Disp1layOb]ectConta 


オブ ジェ クト を 2D 回 | rotation : 
転 する Number 

























オブ ジェ クト を 3D 回 | rotationX: rotationX、rotationY、rotationZ は それ ぞ れ x 軸 、 
転 す る rota1OnY : y 軸 、z 軸 を 回 転 軸 と し て 表示 オブ ジェ クト を 回 転 
roO キ 上 a 七 1OnZ : し ます 。 


NumDper 






オブ ジェ クト の 周囲 | scale9Grid: 
を 拡大 / 縮 小 用 に 調整 | Rectangle 
する 


オブ ジェ クト を 拡大 / 
縮小 する 


主 に 角 が 丸い 四角 形 の 四角 形 を 拡大 / 縮 小 す る と 
き に 生じ る 歪み を 防ぐ た め に 、4 辺 と 4 つの 角 の 8 
部 分 それ ぞ れ に 拡大 / 縮 小 の 規則 を 設け ます 。 


それ ぞ れ 基準 点 か ら の 水平 / 垂 直 / 奥 行き スケ ー ル 
を 倍率 で 設定 し ます 。 























CaleX : 
8Ca1eY: 
8Ca1eZ : 
NumDer エ 



















表示 オブ ジェ クト を トリ ミン グ し ます 。 指定 する 
Rectangle オ ブ ジ ェクト の x、y 座 標 と 高 さ 、 幅 が 
オブ ジェ クト の 「 見 える 部 分 」 を 決め る 要因 に な 
り ま す 。Rectangle オ ブ ジ ェクト の プロ パテ ィ を 
変化 させ る こと で トリ ミン グ 和 領域 を スク ロー ル す 
る な ど が 可能 で す 。 


ステ ー ジ オプ ジー ェ ク | gEage: この プロ パテ ィ で Stage オ ブ ジ ェクト へ の 参照 を 
ト を 参照 する Stage 得る こと が で きま す 。 


8C エ YO 1ReC : 
Rectand1e 


オブ ジェ クト の 表示 部 
分 を トリ ミン グ す る 






オブ ジェ クト を 表示 / | vis1ble: true : 表示 オブ ジェ クト を 表示 し ます 。 
非 表 示 に する Boolean false : 表示 オブ ジェ クト を 非 表 示 に し ます 。 


オブ ジェ クト の 位置 | x: 親 と な る DisplayObjectContainer を 基準 と し た 
座標 を 取得 / 設 定 す る | \: 水平 、 垂 直 、 奥 行き 座標 を 表し ます 。 





7ー-2- 1 
表示 オブ ジェ クト (DisplayObject オ ブ ジ ェクト ) を 使う 


憩 DisplayObject ク ラス の 主 な プロ パテ ィ ( フ ァイル の 読み 込み 、 ロ ー ド 関連 ) 


SWF フ ァイル 、 画 像 ファ イル の | 1oaqdertnfo 表示 オブ ジェ クト が 属す る SWF フ ァイル の ロー 
読み 込み 情報 を 取得 する : LoaderTnfEo | ド 状 況 に 関す る 情報 を 持つ Loaderlnfo オ ブ ジ ェ 
クト に アク セス で きま す 。 
























委 DisplayObject ク ラス の 主 な メソ ッ ド 概要 


222 吉 メソ ッ ド の 人 


表示 オブ ジェ クト | getBounds ( 表示 オブ ジェ クト の 領域 を 表す 乱 形 を 取得 で き 
の 領域 を 座標 で 取 | targetCoordinateSpace: | ます 。 領域 は 境界 ボッ クス と も 呼ば れ ま す 。 

得する Disp1ayOb] ec getBounds() メ ソ ッ ド は 境界 線 を 含む 領域 を 
) : Rectangd1e 返し 、getRect() メ ソ ッ ド は 境界 線 を 含ま な い 


























qetRect ( 
tarqdetCoordinateSpaCe : 
DisplayOb] ec 

) : Rectand1e 





















グロ ー バ ル 座 標 
っ ロー カル 座標 変 
換 す る 


qloba1ToLoca] ( 
po1nt : Po1n 
) : Po1n 上 


ステ ー ジ 左上 を 基準 と する グロ ー バ ル 座 標 と 親 
DisplayObjectContainer オ ブ ジ ェクト を 基準 
と する ロー カル 座標 を 変換 で きま す 。 
globalToLocal() : グロ ー バ ルー ロー カル 変換 
localToGlobal() : ロー カル ー グ ロー バル 変換 
globalToLocal3D() : グロ ー バ ル 2 次 元 ポ イン 
ト を ロー カル の 3 次 元 座標 に 変換 
local3DToGlobal() : ロー カル の 3 次 元 座標 を 
グロ ー バ ル 2 次 元 ポ イン ト に 変換 













1oca1ToG1oba1 ( 
po1nt : Po1nt 
) : Po ュ in 












loba1ToLoca13D ( 
point : Po1n 
) : Vector3D 









1oca13DToG1oba1 ( 
po1nt3d : Vector3D 
) : Po1n 













他 の 表示 オブ ジェ | hitTestOb]ect ( 
クト と 重なっ て い | ob] : Disp1ayOb] ec 
る か 判定 する ) : Boolean 


ある 座標 と 接触 し 
て いる か 判定 する 


他 の 表示 オブ ジェ クト と 重なっ て いる か を 判定 
し 表す ずら 

















hitTestPoin ( 
メ : NumDer , 
Y : NumDer , 
8hapeF laq : BoOoolean = 
False 
) : Boo1ean 


表示 オブ ジェ クト が 指定 し た 座標 と 重なっ て い 
る か を 判定 し ます 。 
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7 - 2 
表示 オブ ジェ クト (DisplayObject) 


逢 DisplayObject ク ラス の 主 な イベ ント 概要 
| イベ ント 名 | イベ ント の 概要 | 
表示 オブ ジェ クト が 表示 added : 表示 リス ト に 表示 オブ ジェ クト が 追加 
リス ト に 追加 / 削 除 さ れ た され た と き に 発生 し ます 。 
removed : 表示 リス ト か ら 表 示 オ ブ プ ジ ェ クト が 


削除 され た と き に 発生 し ます 。 


GmOVeQF エ Om 
ら ヒ ad@6 


フレ ー ム レー ト の 時 間 間 | enterFrame enterFrame : 再生 ヘッ ド が 新しい フレ ー ム に 


隔 で 処理 を 行う 人 入る と き に 送出 され ます 。 
exitFrame : 再生 ヘッ ド が フレ ー ム を 終了 する 
と き に 送出 され ます 。 
共通 事項 : 用 生 ヘ ッ ド を 移動 し な いか 、 フ レー 
ム が 1 つの 場合 、 同 じ フ レー ム で 繰り 返し 発生 し 
ます 。 そ の た め 、 フ レー ムレ ー ト の 時 間 間 隔 で 
処理 を 行う の に 適し て いま す 。 


符 DisplayObjectContainer ク ラス の 主 な メソ ッ ド 概要 (引数 は 省略 ) 



























表示 オブ ジェ クト を 追加 する addChi1d 表示 オブ ジェ クト イン スタ ンス を 子 と し て 追加 
し ます 。 
addChi1qAt 表示 オブ ジェ クト イン スタ ンス を 指定 され た 位 
置 に 子 と し て 追加 し ます 。 
getChi1dAE イン デック ス を 指定 し て 子 表 示 オ ブ ジ ェクト を 
取得 し ます 。 
getChi1dBy 名 前 を 指定 し て 一 致す る 子 表示 オブ ジェ クト を 
name 取得 し ます 。 
removeCh1i 1d 指定 し た 表示 オブ ジェ クト を 子 リ スト か ら 削 除 
じ 表 ま 。 
removeChi 1d イン デック ス で 指定 し た 表示 オブ ジェ クト を 子 
At リス ト か ら 削 除 し ます 。 


子 表示 オブ ジェ クト の イン デ ッ | getChi1d 指定 し た 表示 オブ ジェ クト の イン デック ス 位 置 
クス を 取得 する Index (番号 ) を 返し ます 。 


子 表示 オブ ジェ クト の イン デ ッ | setChi1d 指定 し た 表示 オブ ジェ クト の イン デック ス 位 置 
クス を 変更 する Tndex (番号 ) を 、 指 定 し た も の に 変更 し ます 。 


子 表示 オ ブ ジ ェクト を 取得 する 


子 表 示 オ ブ プ ジ ェ クト を 削除 する 


乱 DisplayObjectContainer ク ラス の 子 オ ブ ジ ェクト 追加 / 削除 に 関す る メソ ッ ド 詳細 


addChi1d child を DisplayObjectContainer オ ブ ジ ェクト の 子 と し て 追加 し ま 
(ch11d:Disp1ayOb]ec) : す 。 追加 され た 表示 オブ ジェ クト は 既存 の 子 オ ブ ジ ェクト の 上 に 
DisplayOb] ec 配置 され 、 前 面 に 表示 され ます 。child が 他 の DisplayObjectConta 
iner オ ブ ジ ェクト の 子 で あっ た 場合 、 そ の 子 オ ブ ジ ェクト は 削除 さ 
れ ま すず す 。 







ーー 
/ 


1 
表示 オブ ジェ クト (DisplayObject オ ブ ジ ェクト ) を 使う 








き DisplayObjectContainer ク ラス の 子 オ プ ジ ェ クト 追加 / 削 除 に 関す る メソ ッ ド 詳細 (続き) 



























































| メソ ッ ド メソ ッ ド の 詳細 
ンー グン | 
ddChi1dAt child を DisplayObjectContainer オ ブ ジ ェクト の 子 と し て 追加 し ま 
chi1d:Disp1ayOb]act , す 。index に より 、 位 置 を 指定 し て 追加 で きま す 。 位置 は O が 最 背 
index : 1n) : 面 で 1、2.… の 順に 前 面 に 追加 され ます 。 す で に 使用 され て いる 番 
DisplayOb]ec1 号 を 指定 し た 場合 、 そ の 番号 以上 の 子 オ ブ ジ ェクト の イン デック 
ス は 繰り 上 げ ら れ ま す 。child が 他 の DisplayObjectContainer オ ブ 
ジェ クト の 子 で あっ た 場合 、 そ の 子 オ ブ ジ ェクト は 削除 され ます 。 
removeChi1d child で 指定 し た 表示 オブ ジェ クト を 表示 リス ト か ら 削 除 し ます 。 
| (Chi1d:Disp1ayODb]@ec) : 削除 され た 表示 オブ ジェ クト の parent プ ロ パ ティ が null に 設定 さ 
| DisplayODb]ecCt れ も ま す 。 | 
removeChi 1dAt1 index で 指定 し た イン デック ス を 持つ 表示 オブ ジェ クト を 表示 リス | 
| (index : im) : ト か ら 削 除 し ます 。 削除 さ れ た 表示 オブ ジェ クト の parent プ ロ パ 
Disp1ayOb]ject ティ が null に 設定 され ます 。 
2 
AMPLE EE 
| ゼ DisplayObjectSampleA_swf BEW x ゼ DisplayObjeSampleA ey 本 IEGW x 





ファ イル (F) 表示 (y) 吊 御 (CO デバ ッ グ (D) ファ イル (F) 表示 ( ツ ) 定 御 (CO デバ ッ グ (D) 








テキ スト を クリ ッ ク す る と 、 ロ ー ド 済み の イメ ー ジ を 表示 リス ト に 追加 し ます 。 


= 上 首 可 m5】 間 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


表示 オフ ジェ クト を 表示 リス ト に 追加 する DispiayObjectSampieA.la 


1mport Flash.d1isplay . Loader : 
1mDor 上 flash .eVen8s .EVent : 
1mpor 上 fFlash.evens .MouseEVent : 


1mport fF]ash.net .URLRequeg : 


// ロ ー ド する ファ イル 名 
Var u エ ] :S 上 rinqg= "1made8/Ha11oween .pnd" : 
var 七 : TextEF1e1d: 


var 1]oader : Loader : 181 


プー ズ 
表示 オブ ジェ クト (DisplayObject) 


LoadTmaqe ( ) : 


/ / 画像 を ロー ド す る 関数 
PART Funotion LoadTmage () { 
1oader = new Loader ( ) : 
1oader . contentTLioaderTnfo . addEventListener (Evernt . COMPLETE , 
CompleteHand] er) : 
Var reque8t : URLReque8gt=new URLRequest (ur] ) : 
1oader . 1oad (requeg) : 


// ロ ー ド 完了 時 の ハン ドラ 関数 

Function completeHand1er (event : Event ) :Yo1d { 
= new TextFie1d() : 
.-autoSize=TextFie1dAutoS8i ze . LEFT : 





EW 
1 2 
t .mult 上 1] 1ne= 七 了 エ UG : 

t .tex モ =" イメ ー ジ の ロー ド が 完了 し まし た 。\n ク リッ ク し て 表示 リス ト に 追加 し ます 。" : 

t .tyDe=TextF1ie1dType .DYNAMTC: 

上 . 上 ex 上 CO1O エ =0XFFFFFF : 

t .addEventListener (MouseEvernt .CLTCK, addLoader ): 

// テ キス ト フ ィ ー ル ド を 表示 リス ト に 追加 

RC 人 科 M ッ ーー 生ま 


// テ キス トク リッ ク 時 の ハン ドラ 関数 

Funotion addLioader (event : Even ) :Yo1d { 
/ / テ キス ト フ ィ ー ル ド を 表示 リス ト か ら 削 除 
removeCh1i1d( も ): 
/ /Loader オ ブ ジ ェクト を 表示 リス ト に 追加 
aaddChi1d (1oader) , 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 ーー 一 ーーーーーーーーーーーーーーーーーーーーー (3③) 


NN) 


表示 オブ ジェ クト の プロ グラ ミン グ を 行う 場合 に も っ と も 基本 と な る 、 表 示 リ スト へ の 追 
加 と 削除 を 確認 する サン プル で す 。① で は 、 作 成 し た テキ スト フィ ー ル ド オ ブ ジ ェクト を 
addChild()) メ ソ ッ ド に より 表示 リス ト へ 追加 し て いま す 。 そ の オブ ジェ クト は ②⑧ で remove 
ChildO0 メ ソ ッ ド に より 削除 し て いま す 。 読み 込ん だ イメ ー ジ ファ イル は Loader オ ブ ジ ェクト 
の 子 と し て 格納 され て いる の で 、Loader オ ブ ジ ェクト を 表示 リス ト に 追加 する こと で 、 画 面 に 
表示 され る よう に な り ま す 。③ で その 処理 を 行っ て いま す 。 
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て アン キン 4 エー 
サイ ズ 変 更 、 EE 





表示 オブ ジェ クト の 位置 と サイ ズ 、 回 転 は プロ パテ ィ 値 を 変更 する こと に より 、 調 整 で きま 
す 。 位置 に 関す る プロ パティ は 、 ス テー ジ 左 上 を 基準 と する グロ ー バ ル 座 標 と 、 親 Display 
ri DisplayObject ク ラ 
ス が 持つ x、y、z の 位置 情報 は ロー カル 座標 を 表し ます 。 こ の こと に より 、 親 コン テ ナ を 移動 、 
回 転 する と 子 の DisplayObject も 一 緒 に 移動 、 回 転 す る こと に な り ま す 。 


生生 2m あ PMPY 


| プロ パテ ィ 








| プロ パテ ィ の 詳細 | 


表示 オブ ジェ クト の 高 さ を ピク セル 単位 で 表し ます 。 こ れ ら プロ パテ ィ に より 、 オ プ ブ 
ジェ クト の サイ ズ を 変更 する と 、 対 応 す る scaleY (height と 対応 )、scaleX (width と 2 








対応 ) も 変化 し ます 。 


ーーーー 











nX | x 軸 /y 軸 /Zz 軸 を 回 転 軸 と し て 表示 オブ ジェ クト を 回 転 し ます 。 


2 次 元 の 回 転 を 行い ます 。 こ の プロ パテ ィ に 値 を 設定 する こと で 、 表 示 オ ブ ジ ェクト を 

回 転 で きま す 。 単位 は 「 度 」 で す 。 プ ラス 値 で 時 計 回 り 、 マ イナ ス 値 を 設定 し て 反 時 計 

っ イー 360 を 超え る 値 の 場合 、360 (の 倍数 ) を 引き 、-360 を 下回る 場 
、 足 すこ と で 角度 が 調整 され ます 。 





Flash Player10/AlR1.5 以 降 の ActionScript 表 示 オ ブ ジ ェクト は すべ て z プ ロ パ ティ を 
持ち 、z 軸 を 利用 し た 3D 座 標 を 使用 で きま す 。z 軸 は オブ ジェ クト を 視点 か ら 遠 ざか る 
位置 を コン トロ ー ル し ます 。 








て 3 「 4 トー ダ 





6 人 
Se 
ら 9 に っ GL え 
っ や へ やつ | と 
・ ー ュ / 
らし の ル ピッ ノン 


: NumDer 


基準 点 か ら の ポ 平 / 垂 直 / 奥 行き スケ ー ル を 倍率 で 語 定 し ます 。 100%% の 大 き さ で 表示 す 
る に は 、 1.0 を 指定 し ます 。 scaleX、 scaleY を 変更 する と height、width プ ロ パ ティ の 
値 も 変化 し ます 。 負 の 値 を 設定 する こと に より 、 左右 (scaleX)、 上 下 (scaleY) の 反転 
も 行え ます 。 











: NumDer 


x 軸 /y 軸 /z 軸 方 向 の ロー カル 座標 を 表し ます 。 親 の DisplayObjectContainer オ ブ ジ ェ 
クト が 移動 や 回 転 を する 場合 、 ロ ー カ ル 座 標 系 も 一 緒 に 移動 、 回 転 し ます 。 つ まり 、 
親 が 90 度 回 転 し た 場合 、 ロ ー カ ル 座 標 の x は 縦 方 向 の 位置 を 表す こと に な り ま す 。 














間 間 間 間 間 mbirurenripererherrtnnheprrpynoititeyiphriveihtnsiiy 


「 ぁ プ DtsplayObjetSampleB.sw 選 ト 選 | ラ DisplayObjectSampleB.swf 
ファ イル (F) 表示 (y) 叶 御 (CO デバ ッ グ (D) ファ イル (F) 表示 (V) 慎 衝 (CO デバ ッ グ (D) 
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プー ズ 
表示 オブ ジェ クト (DisplayObject) 





= を 1 画 コ 首 呈 mp】 コ 紅 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ステ ー ジ の 拡大 / 縮 小 モ ー ド を 確認 する DisplayObjectSampleB.ila 


1mport fF]ash .d1gsplay . Loader : 
PART 1mpor 上 Fl]ash .eVvent8 .*: 


1mport Flash .net .URLReques : 


// ロ ー ド する ファ イル 名 

Var Url :S 上 ind= "Ha11oween .pnd" : 
Var 上 :TextF1e1d: 

var loader : Loader : 


LoadTmaqde ( ) : 


/ / 画 像 を ロー ド す る 関数 

function LoadTmage() { 

1oader = new Loader ( ) : 

1oader . ContentTLoaderTnfo . adQdEventL1stener (Event . COMPLETE , 
comp1eteHand]1er) : 

Var requegt :URLReque8t 上 =new URLRequegt (ur] ) : 
1oader . 1oad (reques 七 ) : 


/ / ロ ー ド 完了 時 の ハン ドラ 関数 
Funotion completeHand1er (event : Event ) : vo1d { 

trace ( "CompleteHanQdler: " + eVen) : 

= new TextF1ie1d() : 

t .aut 上 OS1ze=TextF1e1dAutoS1 ze . LEFT : 

上 .mul 上 1] 1n ら = ヒエ UG : 

t .tex モ =" リ イ メ ー ジ の ロー ド が 完了 し まし た 。\ ぎ nm クリック し て 表示 リス ト に 追加 し ます 。" : 

t .type=TextFie1dType .DYNAMTC: 

t .Eex 上 CO1Or=0xXFFFFEFF: 

t .addEventL1istener (MouseEvernt .CLTCK, addLoader ): 

// テ キス ト フ ィ ー ル ド を 表示 リス ト に 追加 し て 位置 を 調整 

addChi1d( t ) : 上 .x = (stage . stageW1dth - 七 .width ) / 2: t 上 .y = 200: 
) L_@① 


// テ キス トク リッ ク 時 の ハン ドラ 関数 


Funotion addLoader (event : Event ) : vo1d { 
/ / テ キス ト フ ィ ー ル ド を 表示 リス ト か ら 削 除 
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ナ こ ルー 
表示 オブ ジェ クト の 位置 と サイ ズ 変 更 、 回 転 


removeCh11d(  ): 

/ / 読 み 込 ん だ Bitmap オ ブ ジ ェクト の サイ ズ と 位置 を 調整 

きわ 0D : B1 も AD = 上 OaGeT COn も en も ぁ &g BB は EmaD: 一 ーーーーーーーーーーーーーーーーーーーー② 
bmp.x = ( stage . stageW1dth - bmp.width ) / 2 + 50: 

bmp.y = ( stage .stageHeight - bmp.height ) / 2: ③ 
bmp .W1dth *= 1.7: bmp.scaleY = 1.7: bmp.rotationY = 45: 

/ /Loader オ プ ジ ェ クト を 表示 リス ト に 追加 

addCh1i1d(1oader) : 


で テキ スト フィ ー ル ド を 評価 リス ト に 追加 し て か ら x 座 標 を ステ ー ジ 幅 と の 差 を 計算 し て 指 
定 し て いま す 。 こ の 式 に より 、 ス テー ジ の 横 中 央 に 配置 し ます 。 y 座 標 は 固定 の 200 で す 。Loa 
der オ ブ ジ ェクト の content プ ロ パ ティ で ロー ド し た ファ イル を 参照 で きま す 。 

沈 回 は イメ ー ジ ファ イル を ロー ド し た の で 、content は Bitmap オ ブ ジ ェクト に な り ま す 。 
② で Bitmap オ ブ ジ ェクト を 取得 し て bmp 変 数 に 格納 し て いま す 。3③ で ビッ トマ ッ プ の 座標 、 
サイ ズ 、3D ロ ー テ ーション を 調整 し て いま す 。 
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表示 オブ ジェ クト の 透明 度 、 マ スク 、 
ブレ ンド モー ド 、 描 画 を 調整 する 





PART 
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表示 オブ ジェ クト の 透明 度 、 マ スク 、 ブ レン ドモ ー ド 、 ベ クタ ー 指 画 の 効率 化 な ど は 
DisplayObject の プロ パテ ィ で 設定 する こと が で きま す 。 ブ レン ドモ ー ド は BlendMode ク ラ 
ス に 定数 が 定義 され て お り 、 そ れ を 指定 する こと で 適用 で きま す 。 


軌 DisplayObject ク ラス の 透明 度 、 マ スク 、 ブ レン ドモ ー ド 、 描 画 に 関す る プロ パテ ィ 詳 細 












プロ パテ ィ の 詳細 


表示 オブ ジェ クト の アル ファ 透明 度 を Number 型 の 数 値 で 設定 し ます 。0.0~ 
1.0 の 範囲 が 指定 で きま す 。0 に 近く な る ほど 透明 度 が 高く な り 、0.0 で 完全 に 
透明 に な り ま す 。 デ フォ ルト は 1.0 で 、 こ れ は 透明 度 が な いこ と を 表し ます 。 


設定 を 行っ た 表示 オブ ジェ クト の ピク セル を 構成 する 赤 、 緑 、 青 の 各 要 素 に つ 
いて 、 背 景 と 指定 され た ブレ ンド を 行い ます 。 設 定 は 決め られ た ブレ ンド 名 を 
String で 指定 し ます が 、BlendMode ク ラス に 定数 が 用 意 さ れ て いま す 。 


この プロ パテ ィ に 設定 され た 表示 オブ ジェ クト で マス ク 処 理 を 行い ます 。 マス 
ク を 解除 する に は 、 プ ロ パ ティ を null に し ます 。 


true : ベク ター 画像 の ビッ トマ ッ プ イメ ー ジ を キャ ッシュ し て 表示 速度 を 向上 
させ る こと を 目的 と し ます 。 画像 の 条件 に より 、 効 果 が 変わ り ま す 。 
false : ビッ トマ ッ プ イメ ー ジ は 作成 され ませ ん 。 


オブ ジェ クト の 背景 の うち 、 指 定 し た 色 に つい て アル ファ チャ ン ネ ル ( 透 明 色 ) 
の 描画 を 行わ ず に パフ ォ ー マ ンス を 向上 させ ます 。cacheAsBitmap と と も に 
使用 し て 表示 速度 を 向上 させ る こと を 目的 と し ます 。 
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:D1isplayOb] ec 























ODaqduGBaCKk 
と Ournd : Ob] ec 


馬 BlendMode ク ラス の 定数 と ブレ ンド の 内 容 


曲 | 0 











デフ ォ ル ト の ブレ ンド 。 表示 オブ ジェ クト の 
ピク セル 値 は 、 背 景 の ピク セル 値 よ り 優先 さ 
れ 、 背 景 の 前 に 表示 され ます 。 透明 な 部 分 で 
は 、 背 景 が 表示 され ます 。 


BlendMode.ADD 表示 オブ ジェ クト の 要素 カラ ー の 値 を 背景 
に 加算 し 、 そ の 際 に 上 限 0OxFF を 適用 し ます 。 


前 景 の ピク セル を 優先 | BlendMode.NORMAL 
させ る (デフォ ルト ) 


2 つの イメ ー ジ 間 で の 色 
を 薄く する ディ ゾル プ ブ を 
アニ メー ショ ン 処 理 す る 









表示 オブ ジェ クト の 各 ピ クセ ル の アル ファ 値 
を 背景 に 適用 し ます 。 親 表示 オブ ジェ クト の 
blendMode が BlendMode.LAYER に 設定 さ 
れ て いる 必要 が あり ます 。 


表示 オブ ジェ クト の 要素 カラ ー と 背景 色 の う 
ち 暗 い ほ う ( 値 が 小さ い ほ う ) の 色 を 選択 し ます 。 


前 景 の アル ファ を 背景 | BlendMode.ALPHA 


に 適用 する 


重ね 合わ せ 表 示 BlendMode.DARKEN 








ナー とみ 
表示 オブ ジェ クト の 透明 度 、 マ スク 、 ブ レン ドモ ー ド 、 描 画 を 調整 する 


怠 BlendMode クラ ス の 定数 と ブレ ンド の 内 容 (続き ) 


明る く て 刺激 的 な 色 の | BlendMode.DIFFERENCE | 表示 オブ ジェ クト の 要素 カラ ー と 背景 色 を 比 
較 し 、2 つ の 要素 カラ ー の うち 明る い ほ う の 
値 か ら 暗 い ほ う の 値 を 差し 引き ます 。 


表示 オブ ジェ クト の アル ファ 値 に 基づい て 背 
景 を 消去 し ます 。 こ れ を 行う に は 、 親 表示 オ 
ブ ジ ェクト の blendMode が BlendMode.LAY 
ER に 設定 され て いる 必要 が あり ます 。 


表示 オブ ジェ クト の 暗 さ に 基づい て 、 各 ピク 
セル の 色 を 調整 し ます 。 表 示 オ ブ ジ ェクト が 
50% グ レー より も 明る い 場 合 、 表 示 オ ブ ジ ェ 
クト と 背景 の 色 が 網 が けさ れ 、 よ り 明 る く な 
り ま す 。 表 示 オ ブ ジ ェクト が 50% グ レー より 
も 暗い 場合 、2 つ の 色 が 乗算 され て 、 よ り 暗 
く な り ま す 。 


特定 の 表示 オブ ジェ クト | BlendMode.LAYER 表示 オブ ジェ クト が 処理 され る 前 に 、 一 時 



















前 景 の アル ファ を 使用 | BlendMode.ERASE 
し た 背景 の 一 部 を 切り 
抜く (消す ) 










隊 影 (シャ ドウ ) 効果 の | BlendMode.HARDLIGHT 


























を 事前 構成 する た め の 一 バッ ファ 内 で 表示 オブ ジェ クト が 事前 に 構成 
時 バッ ファ を 強制 的 に 作 され ます 。 ビ ッ ト マ ッ プ キャ ッシュ を 使用 し 


成 て 表示 オブ ジェ クト が 事前 キャ ヤッ シュ され る 


際 、 目 動 的 に 実行 され ます 。 


表示 オブ ジェ クト の 要素 カラ ー と 背景 色 の う 
ち 明 る い ほ う ( 値 が 大 きい ほう ) の 色 を 選択 し 
ます 。 


表示 オブ ジェ クト の 要素 カラ ー の 値 と 背景 色 
の 要素 カラ ー の 値 を 乗算 し た 後 、0xFF で 割っ 
て 正規 化し 、 色 を 暗く し ます 。 


陰影 (シャ ドウ ) 効果 の | BlendMode.OVERLAY 景 の 暗 さ に 基づい て 、 各 ピク セル の 色 を 調 
作成 整 し ます 。 


ハイ ライ ト と レン ズ の | BlendMode.SCREEN 表示 オブ ジェ クト の 色 の 補 数 ( 逆 ) と 背景 色 の 
フレ ア (表示 オブ ジェ ク 補 数 を 乗算 し て 、 ブ リー チ 効 果 を 得 ま す 。 
ト の 黒い 領域 の 削除 ) 


ピク セル ブレ ンダ シェ ー | BlendMode.SHADER カス タム シェ ー ダ ルー チン を 使用 し て 、 カ ラ 
ダ を 使っ て カス タム ブレ ー を 調整 し ます 。 使 用 する シェ ー ダ は 、ble 
ンド 効果 を 作成 ndShader プ ロ パ ティ に 割り 当て られ た Sha 





重ね 合わ せ 表 示 





BlendMode.LIGHTEN 







影 ( シ ャ ドウ ) と 深度 効 | BlendMode.MULTIPLY 











der イ ンス タン ス と し て 指定 され ます 。 


2 つの イメ ー ジ 間 で の 色 | BlendMode.SUBTRACT | 下限 を 0 と し て 、 表 示 オ ブ ジ ェクト の 要素 カ 
を 濃く する ディ ゾル ブ 効 ラー の 値 を その 背景 色 の 値 か ら 減算 し ます 。 
果 を アニ メー ショ ン す る 
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プー ズ 
表示 オブ ジェ クト (DisplayObject) 


1 軒 間 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


こも MPP お 7 


ーーー 吉 0 ーー デバ ッ グ (の ) 


PART 


っ TI 





ーーーー あぶ (O デバ ッ ク (6) 





= た 1 目 コ 首 mmlp1 コ 粒 ---。。 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


ブレ ンド モー ド の 変更 と 確認 DisplayObjectSampleC.fa 
1mport fl1ash.display .BlenQaMode : 
1mpor f1] .cContro1]g . Rad1OBu 二 On : 
1mDpor Ff1] .Contro18 . Rad1OBu 二 上 OnGTOUD : 


// ブ レン ドモ ー ド を 選択 する ラジ オ ボ タ ン の 設定 
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ーー スー 
表示 オブ ジェ クト の 透明 度 、 マ スク 、 ブ レン ドモ ー ド 、 描 画 を 調整 する 


Yar rd:Rad1OBu 上 上 OnGrOuD = new RadioButtonGroup ( "b1endMode" )j』 
rd . addEventListener ( Event .CHANGE , setCurrentB1]enQdMode ) : 
For ( Var i:int = 0 : 1 < his.numChi1dren : 1++ ) { 


if ( thigs.getChi1qdAt( 1 ) sg RadioButton ) { 


(づつ) 


( this .detCh1i1dAt( 1 ) ag Rad1ioButton ) .drOuD = rd: 


) ば 0 


Var CurrentB] endMode : St 上 rinq = BlendMode . NORMAT : 
mode xt .tex 上 = BlendMode .NORMAL : 


/ / 円 形 の 表示 オブ ジェ クト に ブレ ン ドモ ー ド を 設定 する 関数 
Function setCurrentB]endMode (event : Event ) :vo1d { 
CurrentB]lenQdMode = BlendMode[ (( event .tarqet ag RadioButton 
Group ) .Selection) .Yalue ] : 
gwitch ( currentB]endMode ) 1 
//ALPHA と ERASE の 場合 、 親 が LAYER で ある こと が 必要 8 
Ca8e BlendMode .ALPHA : 
Ca8e BlendaMode . ERASE : 
this .b1endMode = BlendMode . LAYER : 





ヾ ) 


breakK: 
defau]: 
this .blendMode = BlendMode . NORMAT : 
break: 
) 
Fron mc.Dbl1endMode = currentB] endMode : 


mode xt .tex 二 = CurrentB]enQdMode : 


⑥ 


① は ブレ ンド モー ド の 選択 を 行う ララ ジオ ボタ ン の 初期 設定 で す 。③ で 前 面 の 丸い イメ ー ジ に 
選択 され た ブレ ンド モー ド を 設定 し ます 。ALPHA と ERASE の 場合 、 必 要 に より 、 親 の ブレ ン 
ドモ ー ド を LAYER に し て いま す 。③ の 1 行 が 表示 オブ ジェ クト に ブレ ンド モー ド を 設定 する 記 
述 で す 。 こ の 人 行 を 実行 する と 画面 上 の 表示 オブ ジェ クト の ブレ ンド が 行わ れ ま す 。 
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7 - 2 
表示 オブ ジェ クト (DisplayObjedt) 


よっ 心 M1 ト F*# | F SI 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ーーーーーーーーーーーーーーーーーーーーーーーーー - 
! の OSASKGSAS 時 昌 了 呈 間 xy 
< い り Ne の ご が に の やさい ー ここ ーー 7 


52 
5 フ 





PART 


= 上 コ 首 叶 mp】 蘭 0-- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


アル ファ 透明 度 の 変更 DisplayObjectSampleD.fla 


// イ ベン トリ スナ ー の 登録 
r g11der .addEventL1istener (Event .CHANGE, setAlpha ): 
す 811ider .addEventLi stener (EVen .CHANGE, setAlpha ): 
b gs1ider .addEventLi stener (Even .CHANGE, setAlpha ): 
// ア ルフ ァ 値 を 変更 する 関数 
Function setAlpha (event : Event ) :vo1d { 
sw1toh ( event .target .name ) { 
Ca8e "エエ 811Qer" リ : 
1maqde r.a1pha = r 811der .Ya1ue : 
DreaK : 
Ca8e " 可 811der" : 
1mage す .a1pha = 9 8S11der .Ya1uG : ゆび 
Dr@aK : 
ca8e "D gs11der": 
1mage b.a1pha = D gl11der .Ya1uG : 


DreaK : 


重なり 合う 3 つの イメ ー ジ の アル ファ を 変更 する サン プル で す 。① で 、 変 更 さ れ た スラ イダ 
ー を 識別 し て 、 表 示 オ ブ ジ ェクト の アル ファ 値 を 変更 し て いま す 。 
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セン キョ ンス は ノル ルン ん 時 < 





四角 い 形 状 の 表示 オブ ジェ クト を 拡大 / 縮 小 す る と き に 4 つの 角 ( エ ッ ジ ) 部 分 は 拡大 、 縮 小 せ 
ず に サイ ズ を 維持 し て お きた いと き に は 、9 ス ライ ス を 設定 し ます 。9 ス ライ ス と は 、 四 角形 を 
上 下 左右 と 4 つの 角 、 お よび 中 央 の 9 部 分 に 分 割 し て それ ぞ れ の 拡大 、 縮 小 率 や 方 向 を 調整 する 
こと で 、 自 然 に 見 える サイ ズ の 変更 を 実現 する も の で す 。 例え ば 角 が 丸い 図形 や 、 額 綴 の よう 
に 拡大 / 縮 小 し た い 部 分 と 外 枠 の 部 分 が 分 か れ て いる イメ ー ジ な ど を 、 違 和 感 な く サ イズ 変更 す 
る こと が で きま す 。 


符 DisplayObject ク ラス の 9 スラ イス に 関す る プロ バテ ィ 詳 細 


プロ パティ の 詳細 SN 


下図 の よう に 9 つの 部 分 か ら な る グリ ッ ド を 設定 し て 各部 分 の 拡大 / 縮 小 の 有無 と 方 向 を 
決め ます 。9 つ の 部 分 は 中 心 部 分 ⑨ を 定義 むす る Rectangle オ ブ ジ ェクト に より 、 決 定 し ま 
す 。Rectangle の x、y は 対象 の 表示 オブ ジェ クト の ロー カル 座標 、width、height で 幅 
と 高 さ を 表し ます 。 





プロ パテ ィ 








Scale9Grid 
:Rectangle 









seale9Grid あ り 
ーー ニュ ー で Ss 





水平 方 向 に の み 拡大 、 縮 小 












垂直 方 向 に の み 拡 大 、 縮 小 
払 大 、 縮 小 な し 
水平 、 垂 直方 向 に 拡大 、 縮 小 

























本 

う ) | @⑥) 1 
5 
CO 
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7-2 
表示 オブ ジェ クト (DisplayObjedt) 





seale9Grid な し 
PART 1 


scaic9Cjrid あ し 





= が 1 目 コ 首 可 mp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


表示 オブ ジェ クト の 9 スラ イス を 設定 する DisplayObjectSampieEla 
//sca1le9Gr1d 用 の Rectang1e 
Yar rect :Rectangle = new Rectangle( 15.5, 14.4, 199.1, 144 ) ,: 一 一 一 ゆ 
//scale9Grid プ ロ パ ティ に 作成 し た Rectang1e オ ブ ジ ェクト を 設定 
沈 量 人 旨 欄 流 NB 可 條 まき 全 晶 ア 4 (が の DE すっ mm アー ーー モー ドー トード ーーー ニー ドーー キ で ーーーーーーー (5 


/ / 拡大 縮小 の た め の ス ライ ダー 設定 
Scale gs11dqder.addEventListener ( Event .CHANGE, setSoale ): 
Funotion setScale (event : Event ) :Yo1d { 

1made moC.SCaleX = eVernt .tarqdet .Ya1UuG : 

1maqde _mC.8CaleY = eVen .tardet .Ya1uG : 

1made2 moC.SCaleX = event .tarqet .Value : 


1maqde2 mcC.SCaleY = event .tarqet .Value : 


で Recangle オ ブ ジ ェクト を 作成 し 、② で 表示 オブ ジェ クト に 設定 し て いま す 。 上 記 の 実 
行 結果 の 写真 は 左 が オリ ジ ナ ル サ イ ズ 、 右 が 2 倍 に 拡大 し た も の で す 。 scale9Grid を 設定 し た 
192 場合 、 メ イン 画像 の 周り の 「 上 ふち 」 の 部 分 が 元 と 同じ 幅 を 維持 する こと が わか り ま す 。 


7 - 3 イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 
シン ルレ ルル k 9 ん アン オン 4 は ん 


イベ ント と プロ パテ ィ を 使う 





表示 オブ ジェ クト に 対す る マウ ス 、 キ ー ボ ー ド や フォ ー カ ス に 関す る 操作 を 処理 する に は 、 
イベ ント の 監視 が 基本 と な り ま す 。 イ ベン ト を 監視 する た め の 仕組 み は DisplayObject ク ラス 
を 基本 クラ ス と する InteractiveObject ク ラス で 提供 され ます 。 


m InteractiveObject ク ラス の 主 な プロ バテ ィ 概 要 


ダブ ルク リッ クイ ペン ト を 受け 取 オブ ジェ クト が ダブ ルク リッ クイ ベン ト 
る / 受 け 取 ら な い を 指定 を 受け 取る か を 決定 し ます 。 


マウ スイ ベン ト を 受け 取る / 受 け 取 マウ スイ ベン ト を 受け 取る か を 決定 。 
ら な いか を 指定 


フォ ー カ ス 息 形 を 表示 する / し な い 
を 指定 


タプ ブ 順 序 に 含め る / 含 め な い を 指定 | LabEnab1ed: 


Boolean 
タブ 移動 順 を 指定 












Enabled: Boolean 













mOuSeEnmaDp1eQ 
: Booean 

























TOCUSRGC 


Ob] ec 


フォ ー カ ス を 得 た と き に 征 形 を 表示 する 
か を 決定 し ます 。 


タプ 移動 順に 含ま れる か を 決定 し ます 。 












タプ 移動 順に 含ま れる 場合 、 そ の 順番 を 
決定 し ます 。 








マウ ス の ボタ ン を 押し て | c1ick 表示 オブ ジェ クト の 上 で マウ ス ボ タ ン を クリ ッ ク す る と 
離し た と き mou8eDown mouseDown、 続 いて ボタ ン を 離す と mouseUp、 そ の 
nouseUDp 後 click が 発生 し ます 。 


マウ ス の ボタ ン を ダブ ル | doub1eC1iclk | マウ ス ボ タ ン を 2 回 続け て クリ ッ ク す る と この イベ ント 
クリ ッ ク し た と き が 送出 され ます 。 


マウ ス を 移動 させ た と き | mouseMove ユー ザ が マウ スカ ー ソ ル を InteractiveObject 上 で 動か し 
て いる 間 、mouseMove イ ベン ト が 連続 し て 発生 し ます 。 


マウ スカ ー ソ ル が オブ | mouseOve+ マウ スカ ー ソ ル が InteractiveObject の 外部 か ら 領域 内 

ジェ クト 内 に 入っ た と き | ro11Ovei に 入る と 、rolIOver、mouseOver イ ベン ト が 送出 され 

/ 出 た と き mou8eOut ます 。 マ ウス カー ソル が InteractiveObject か ら 外 に 移 
Fo11Ou1 る と 、mouseOut、rollIOut イ ベン ト が 送出 され ます 。 


マウ スホイ ー ル を 回 転 さ | mouseWhee] InteractiveObject 上 で マウ スホイ ー ル を 回 転 さ せ た と 
せ た と き き 、 こ の イベ ント が 送出 され ます 。 


マウ ス に より オブ ジェ ク | mouseFocug mouseFocusChange イ ベン ト は 現在 フォ ー カ ス を 持っ 
ト が フォ ー カ ス を 取得 / | Change て いる オブ ジェ クト が マウ ス 操 作 に よっ て フォ ー カ ス を 
喪失 し た と き 変更 され る 直前 に 送出 され ます 。 
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PART 
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マウ スイ ベン ト を 処理 する 





表示 オブ ジェ クト に 対す る マウ ス 操 作 を ActionScript で 操作 する に は 、InteractiveObject 
クラ ス で 提供 され る イベ ント 処理 を 利用 し ます 。 イ ンタ ラク ティ ブ な 操作 を 行う Display 
ObjectContainer、SimpleButton、TextField、Loader、Sprite、Stage、MovieClip な ど 
の クラ ス は すべ て InteractiveObject を 大 本 と し て 作成 され て いる た め 、 マ ウス に 関す る イベ 
ント の 処理 方 法 は 共通 に な り ま す 。 オ ブ ジ ェクト が マウ スイ ベン ト を 受け 取る / 受 け 取 ら な い の 
コン トロ ー ル は 、InteractiveObject.mouseEnabled、doubleClickEnabled プ ロバ ティ で 
制御 する こと が で きま す 。 マ ウス に 関す る イベ ント 名 は MouseEvent ク ラス に 定数 が 用 意 さ れ 
て いま す 。 ま た 、 マ ウス イベ ント が 発生 する と や は り MouseEvent ク ラス の オブ ジェ クト が 生 
成 さ れ 、 情 報 が 格納 され ます 。 


符 InteractiveObject ク ラス の マウ ス 処 理 に 関す る プロ パテ ィ 詳 細 


プロ パテ ィ プロ パテ ィ の 詳細 


mouseErmab1 ed オブ ジェ クト が マウ ス に 関す る イベ ント メッ セー ジ を 受け る か を 決定 し ます 。 
: Boo]1ean た だ し 、 こ の オブ ジェ クト に 子 が ある 場合 、 そ の 子 が マウ スイ ベン ト を 受け 取 
る か まで は 、 親 の プロ パテ ィ で は コン トロ ー ル で きま せん 。 子 オブ ジェ クト の 
マウ ス 処 理 を 制限 する に は 、DisplayObjectContainer ク ラス に ある mouse 
Children プ ロ パ ティ を false に し ます 。 
true : オブ ジェ クト は マウ スイ ベン ト を 受け 取り ます (デフォルト )。 
false : オブ ジェ クト は マウ スイ ベン ト を 受け 取り ませ ん 。 


doub1eC1iok デフ ォ ル ト で は InteractiveObject は doubleClick イ ベン ト の 受け 取り を し な い 
Enabled:Boolean | た め 、 ダ ブル クリ ッ ク 処 理 を する に は 、 こ の プロ パテ ィ を true に し て お く 必 要 
が あり ます 。 ま た 、mouseEnabled プ ロ パ ティ が false に な っ て いる と double 
Click イ ベン ト も 通知 され な い の で 、 こ ちら も true に し て お く 必 要 が あり ます 。 
true : オブ ジェ クト は ダブ ルク リッ クイ ベン ト を 受け 取り ます 。 
false: オブ ジェ クト は ダブ ルク リッ クイ ベン ト を 受け 取り ませ ん (デフ ォ ル 
ト )。 





生 InteractiveObject ク ラス の マウ ス に 関す る イベ ント 詳細 


イベ ント (下段 は MouseEvent | イベ ント の 詳細 
クラ ス 定 数 ) 


c] ick ユー ザ が オブ ジェ クト の 上 で マウ スポ ボ タン を クリ ッ ク す る と mouse 
mouseDown Down イ ベン ト 、 続 いて ボタ ン を 離す と mouseUp イ ベン ト 、 そ の 
mouSeUD 後 cick イ ベン ト が 発生 し ます 。 オ ブ プ ジ ェ クト 内 で mouseDown を 発 


生 さ せ て ボタ ン を 押し た まま オブ ジェ クト 領域 を 外れ て mouseUp 
し た 場合 、click イ ベン ト は 発生 し ませ ん 。 同じ よ うに 、 オ ブ ジ ェ ク 





ChTCK ト 外 で mouseDown、 そ の 後 ボ タン を 押し た まま オブ ジェ クト 領域 
MOUSE_DOWN で mouseUp の 場合 も click は 発生 し ませ ん 。 
MOUSE UP つま り 、 オ ブ ジ ェクト 内 で 確実 に マウ ス ボ タ ン を 押し て 離し た 場合 


の み 、click が 発生 し ます 。 





プー ゴー メ 
マウ スイ ベン ト を 和 負 理 する 


乱 InteractiveObject ク ラス の マウ ス に 関す る イベ ント 詳細 (続き ) 


イベ ント (下段 は MouseEvent | イベ ント の 詳細 
クラ ス 定 数 ) 
QdoubleC1 icCk オブ ジェ クト 上 の ダブ ルク リッ ク を 知ら せる イベ ント で す 。 double 
発生 する 必要 が あり ます 。 
この イベ ント を 処理 する に は 、doubleClickEnabled プ ロ パ ティ を 


true に し て お く 必 要 が あり ます 。 
mou8eMove オブ ジェ クト 上 で ユー ザ が マウ スポ イン タ を 移動 し た と き に 継続 的 
に 発生 し ます 。 

























mouSeOver マウ スカ ー ソ ル が InteractiveObject の 外部 か ら 領 域内 に 入る と 、 
ro1 1Over rolIOver イ ベン ト に 続い て mouseOver イ ベン ト が 送出 され ます 。 
mouSeOut その オブ ジェ クト 内 の 子 InteractiveObject に カー ソル が 移動 し 、 


ro11Out 再び 領域 内 に 入っ た と き 、 mouseOver イ ベン ト の み が 送 出さ れ ま す 。 
マウ スカ ー ソ ル が InteractiveObject か ら 外 に 移る と 、mouseOut 


イベ ント に 続い て rolIOut イ ベン ト が 送出 され ます 。 






















MOUSE OVER 


ROLhh_OVER mouseOut イ ベン ト は 子 InteractiveObject に カー ソル が 移動 する 
ARE MA と き に も 発生 し ます 
ROLL, OUT - 





オブ ジェ クト 上 で マウ スホイ ー ル を 回 転 させ た と き に 発生 し ます 。 


オブ ジェ クト が 現在 フォ ー カ ス を 持っ て いて 、 ユ ー ザ の マウ ス 操 作 


に より フォ ー カ ス を 失 お うと する と き に 発生 し ます 。 フォー カス を 
MOUSE_ FOCUS_CHANGE 失っ た 後 は focusOut イ ベン ト が 発生 し ます (FocusEvent ク ラス )。 






息 MouseEvent ク ラス の マウ スイ ベン ト に 関す る プロ パテ ィ 


プロ ティ | フロ バテ ィ の 骨 
At キー が 押さ れ て いる か a1tKey true : At キー が 押さ れ て いま す 。 
: Boo]ean false : At キー は 押さ れ て いま せん 。 
マウ ス の 主 ボ タン が 押さ れ | buttonDown | true : 主 ボ タン が 押さ れ て いま す 。 
て いる か : Boo]ean false : 主 ボ タン は 押さ れ て いま せん 。 


Ctrl キー が 押さ れ て いる か | ctr1Key true : Ctrl キー が 押さ れ て いま す 。 
(Windows/Linux) : Boo1ean false : Ctrl キー は 押さ れ て いま せん 。 


マウ スホイ ー ル の 1 目盛 り 正 の delta 値 は 上 方 向 、 負 の 値 は 下方 向 へ の スク ロー ル 
・ 1 ロト 



























で スク ロー ル す る 行 数 を 表し ます 。 ホ イー ル の 回 転 が 速 く な る と 、delta の 値 
は 大 きく な り ま す 。 設定 値 は 、 デ バイ ス や オペ レー ティ 
ング シス テム で 異な り ま す 。 


















マウ スイ ベン ト の 発生 位置 | 1oca1X 表示 チェ ー ン の 最 下 位 の 子 で の クリ ッ ク 位 置 座標 を 示し 
(ロー カル 座標 ) 1oca1Y まず す 。 

: NumDer 
Shift キ ー が 押さ れ て いる | Sh1fEtKey true : Shift キ ー が 押さ れ て いま す 。 
か : Bool] ean false : Shift キ ー は 押さ れ て いま せん 。 
マウ スイ ベン ト の 発生 位置 | staqgeX ステ ー ジ を 基準 と し た クリ ッ ク 位 置 座標 を 示し ます 。 
(グロ ー バ ル 座 標 ) StadeY 


: NumDer 
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7-3 
イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 


uuY モ 


- 1 te v Q jec 5 n le 5 で SS に Ao ce ca 7 2 SS べ 0 し So の 
、 ファ イル (PF) 表示 (y) 吊 御 (CCO デバ ッ グ OD) 


ーー ニニ ーー ニュ ニー ニー ニー ーー 
{ 人 生 205、 の の 、 きす ー 
_- 
! 3 | 








この サン プル は 、 イ メー ジ 上 で 発生 し た マウ スイ ベン ト 名 を すべ て 表示 する も の で す 。 


= を 1 画 コ 首相 mp】 コ 蘭 ----- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


マウ スク リッ クイ ベン ト を 処理 する IntractiveObjectSampleAla 


1mport fF] .manader8 .FOCuSManader: 


① 


Var fm:FoCusManader = new FocuSManaqder( th18 ): 


// イ メー ジ に 対す る マウ スイ ベン トバ ハン ドラ を 設定 

Coing mo.addEventListener( MouseEvent .CLTCK, ghowEven ): 

Coins mo.addEventListener( MouseEvent .MOUSE DOWN, showEvent ): 
Coins mo.addEventL1stener( MouseEven .DOUBLE CLTCK, showEvent ): 
Coings mc.addEventL1stener( MouseEven .MOUSE DOWN, showEvent ): 
Coins mo.addEventListener( MouseEvent .MOUSE MOVE, showEvent ): 
Coins mc.addEventListener( MouseEven .MOUSE OUT, showEvent ): ② 
Coing mo.addEventListener( MouseEvent .MOUSE OVER, showEvent ): 
Coins mc.addEventListener( MouseEven キ .MOUSE UP, showEvent ): 
Coins mc.addEventLigstener( MouseEvent .MOUSE WHEEL, showEvent )。: 
Coins mo.addEventListener( MouseEvent . ROLL, OUT, showEVent ): 
Coing mc.addEventListener( MouseEvent . ROLL OVER, ghowEvent ): 


//doub1eC1ickEnab1ed チ ェ ッ クボ ックス の イベ ント ハン ドラ 
db1C1iockEnab1ed chk .addEventL1stener( MouseEvent .CLTCK, 


か ーー 
マウ スイ ベン ト を 処理 する 


setDb1C1ickEnabled ): 
mouseEnabled chk .addEventL1stener( MouseEvent .CLTCK, setMouseEnab] ed 
) : 


/ / テ キス ト の 選択 範囲 を 示す た め の 変 数 
Var 81Qdx : 1n 革 , 11dx:1n 七 : 
function ghowEvent ( event : Event ) :vo1d { 
81dx = messade xt .1ength: 
//event .type で イベ ント 名 を 取り 出し て 出力 する 
08 お る 9@ も XC 。ADperiGTexxE( eVent .EyB@ ) : 一 一 一 ーーーーーーーーーーーーーーーーーー③ 
11idx = messade xt .1ength: 
me88ade xt .appendText( "\ ぎ mn" ): 
Fm.setFocus( message xt ): 


me88ade tx .setSelection( gs1dx, 11dx ): 
es 





Funotion setDb1C] ickEnab1ed (event : Event ) : vo1d { 
// イ メー ジ が ダブ ルク リッ クイ ベン ト を 受け 取る / 受 け 取 ら な いよ うに 設定 





Coins mc.doubleC1ickEnab1ed = db1C1]ickEnab1ed chk.seleocted: ④ 
) 
Function setMouseEnab]ed (event : Event ) :vo1d 1 

/ / マ ウス イベ ント を 処理 する / 処 理 し な い を 設定 

Coin8 mc.mou8eErnabled = mouseEnabled chk.seleocted : 一 ーーーーーーーーーー⑤ 


は TextArea に フォ ー カ ス を 与え る 処理 で 、 マ ウス イベ ント 処 理 と は 関係 あり ませ ん 。? 
で InteractiveObject (ここ で は イメ ー ジ を シン ボル 化し た MovieClip) で 処理 で きる すべ て の 
マウ スイ ベン ト を showEvent() 関 数 で ハン ドル する よう に し て いま す 。 こ の 関数 で は (3 で 使用 
し て いる 、 イ ベン ト の 名 前 を 表す Event オ ブ ジ ェクト の type プ ロバ ティ だ けが 重要 で す 。 こ の 
場所 以外 の 処理 は TextArea に 追加 し た テキ スト を 選択 状態 に する こと を 行っ て いる だ け で す 。 

動か す と わか り ま す が 、 こ の まま で は ダブ ルク リッ クイ ベン ト は 処理 され ませ ん 。 チ ェ ッ ク 
ボッ クス の オン / オ フ で ダブ ルク リッ クイ ベン ト を 受け 取る よう に doubleClickEnabled プ ロ パ 
ティ を 設定 し て いる の が '4 で す 。⑤5 で 行っ て いる よう に 、mouseEnabled プ ロ パ ティ を true( デ 
フォ ルト ) /false に する こと で 、 マ ウス イベ ント を 受け 取る / 受 け 取 ら な い を 変更 で きま す 。 
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キー ボー ドイ ベン ト を 処理 する 
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表示 オブ ジェ クト に 対す る キー ボー ド 操 作 を 処理 する た め の 仕 組み は 、InteractiveObject 
クラ ス で 提供 され ます 。 イ ンタ ラク ティ ブ な 操作 を 行う DisplayObjectContainer、Simple 
Button、TextField、Loader、Sprite、Stage、MovieClip な どの クラ ス は すべ て この Inter 
activeObject を 基本 と し て 作成 され て いる た め 、 マ ウス 処理 と 同じ よう に キー ボー ド に 関す る 
イベ ント 処理 は 共通 に な り ま す 。 キ ー ボ ー ド イベ ント が 発生 する と 、KeyboardEvent ク ラス 
の オブ ジェ クト が 生成 され 、 情 報 が 格納 され ます 。OS や Web ブラ ウザ は 、Flash Player よ り 
先 に キー ボー ドイ ベン ト を 処理 する た め 、 例え ば Windows で は 、Alt + Tab キー を 押し た と き 、 
Flash Player が キー ボー ドイ ベン ト を 送出 する 前 に 、 ブ ラウ ザ か ら 他 の アプ リケーション に 
ウィ ンド ウ を 移す 操作 に な り ま す 。 


乱 InteractiveObject ク ラス の キー ボー ド に 関す る イベ ント 詳細 


イベ ント (下段 は 定数 ) イベ ント の 詳細 
keyFocusChange ユー ザ の キー ボー ド 操 作 に より 現在 の オブ ジェ クト が フォ ー カ ス を 失 お う 


と する と き に 発生 し ます 。 フォー カス を 失っ た 後 は focusOut イ ベン ト が 
KEY DOWN 
KEY UP 


















発生 し ます 。 フ ォ ー カ ス が 移動 し た 先 の オブ ジェ クト で は focusIn イ ベン 
ト が 発生 し ます 。 こ の 定数 は FocusEvent ク ラス で 定義 され て いま す 。 


オブ ジェ クト が フォ ー カ ス を 得 た 状態 で キー ボー ド が 押さ れる と key 
Down イ ベン ト が 発生 し ます 。 押 し 続け て いる 場合 、 連 続 的 に イベ ント が 
発生 し ます 。 キ ー を 離す と keyUp イ ベン ト が 発生 し ます 。Stage に key 
Down/keyUp イ ベン トリ スナ ー を 設定 する と 、 ア プリ ケー ショ ン 稼 働 中 
に 発生 し た すべ て の キー ボー ドイ ベン ト を 処理 で きま す 。 

イベ ント オブ ジェ クト と し て KeyboardEvent オ ブ ジ ェクト が 作成 され ま 
す が 、 そ の プロ パテ ィ で command/ctrl/alt/shift キ ー な どの 情報 を 調べ 
る と と が で きま すず す 。 

キー イベ ント を 表す 定数 は KeyboardEvent ク ラス で 定義 され て いま す 。 









乱 KeyboardEvent ク ラス の マウ スイ ベン ト に 関す る プロ バテ ィ 


11 EKGN trUGe ・ At キー が 押さ れ て いま す 。 
: Boo1ean false : At キー は 押さ れ て いま せん 。 


At キー が 押さ れ て いる か 


どの キー が 押さ れ た か charCode | 押さ れ た キー (離さ れ た キー) の 文字 コー ド 値 を 取得 で 
きま す 。 


Ctrl (Windows/Linux) / | CEr1LKey true : Ctrl/Command キ ー が 押さ れ て いま す 。 
Command (Mac OS) キー | :Boolean false : Ctrl/Command キ ー は 押さ れ て いま せん 。 
が 押さ れ て いる か 


キー コー ド 値 keyCode | 押さ れ た キー (離さ れ た キー) の キー コー ド 値 を 取得 で 
きま す 。 キ ー コ ー ド は キー ボー ド 上 の キー を 識別 する た 
め の 数値 コ ー ド で す 。 














圭 KeyboardEvent ク ラス の マウ スイ ベン ト に 関す る プロ バテ ィ ( 続 き ) 


目 人 | プロ バテ ィ 名 | プロ バテ ィ の 要 要 2 
2 に EGGANSSROSDDNYRE 





| キー ボー ド の キー の 場所 


・u1mn ヒ 








ェ ューー 





| LEFTI) 


ゲー ラー 
キー ボー ドイ ベン ト を 処理 する 











' の つ あ る Shift キ ー の うち 左右 どちら が 押さ れ た か 」、「 数 


値 が テン キー で 入力 され た か 」 な ど 、 同 一 文字 で 2 種類 | 


の キー が ある 場合 の 識別 情報 を 提供 し ます 。KeyLoca 
tion ク ラス に 次 の 定数 が 用 意 さ れ て いま す 。 


。 


キー の 区 別 が な いか 、 テ ン キ ー 
で な い キ ー が 押さ れ ま し た 。 


左側 に ある キー が 押さ れ ま し た 。 
石 側 に ある キー が 押さ れ ま し た 。 


テン キー が 押さ れ ま し た 。 








定数 名 (uint 値 ) 
STANDATD(O) 




















RIGHT(Z) 











NUM_PAD(3) 











Shift キ ー が 押さ れ て いる か | shifEtKey 

















true : Shift キ ー が 押さ れ て いま す 
false : Shift キ ー は 押さ れ て いま せん 











ご InteractiveObjedtSarmpleB.swf 
ファ イル (F) 表示 (y) 冗 御 ( 〇 O デバ ッ グ (D) 


に た? 画 首相 mp】 ヨ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 














= 上衣 画 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


キー ボー ド が 押さ れ た / 離 され た イベ ント と 押さ れ た キー を 取得 する Itractive0bjectSampleB la 
// ス テー ジ で キー ボー ドイ ベン ト を 取得 する た め の イ ベン トバ ハン ドラ の 登録 
8tage . addEventLi1stener( KeyboarQdEvent . KEY DOWN, showKey ) : 一 ーーーーーー①⑬ 


/ / KeyjbordEvent を 処理 する ルン ドラ 


Funoction showKey ( event : KeyboardEvent ) :Yo1d { 


Char tx .Eext = Str1ng . FromCharCode( evenrnt .keyCode ) :-ーーーーーーーーー の ②⑧ 


/ /keyCode の 表示 
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プー3 
イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 


keycode txt.text = evenrnt .keyCode .toStrind() : 
/ / 文字 の アル ファ 値 を 元 に 戻す 
a1t txt.a1pha = 0.3: Shift tx .a]pha = 0.3: Cctr] xt.alpha = 0.3: 
PART / /A1t キ ー の 判定 
if ( event .a1tKey ) { 
a1t txt.alpha = 100: 


) 

/ / ShifEt キ ー の 判定 

if ( event.shiftKey ) { 
Sh1fFt txt.alpha = 100: 


) 

/ /Ctr1 キ ー の 判定 

if ( event .ctr1Key ) { 
Ctr] tx モ 上.a1pha = 100: 


) 


/ /keyLocation の 判定 
key1ocation txt .text = event .keyLoca1on . モ OS 上 imnd ( ) : 一 ーーーーーーーーー ③ 


の コー ド に より 、 ス テー ジ 上 の キー 入力 を showKey() 関 数 で 処理 で きま す 。② で Key 
boardEvent オ ブ ジ ェクト の keyCode プ ロ パ ティ で 取得 し た キー コー ド を 文字 に 変更 し て いま 
す 。keyCode プ ロ パ ティ は IME が オン の と き は 正常 な コー ド を 返し ませ ん 。 つ まり 、Ascii 文 
字 の み を サポ ー ト し ます 。3 で 行っ て いる keyLocation プ ロバ パテ ィ に より 、 キ ー ボ ー ド の 左側 
/ 右側 どちら の Ctrl キー が 押さ れ た か 、 テ ン キ ー が 押さ れ た か な ど が 判定 で きま す 。 

ムー ビー プレ ビュ ー の と き に Ctrl + S な どの キー 入力 は ショ ー ト カッ ト と し て 登録 され て お 
り 、 ア プリ ケー ショ ン よ り 先 に 処理 され て し まう た め 、 キ ャ ブチ ャ ー さ れ ま せん 。 こ の よう な 
キー 操作 を 判定 する に は 、 プ ロジ ェ ク タ の [| 制御] メニ ュー の [キー ボー ド シ ョ ー ト カッ ト を 無効 ] 
に チェ ッ ク を つけ ます 。 た だ し 、Alt キ ー は プロ ジェ クタ 自体 の メニ ュー を 選択 し て し まう た め 、 
アプ リケーション で は キャ プチ ャ ー で きま せん 。 


283 
再生 (PD 
巻 戻し (R) 


ルー プ (L) 


1 フレ ー ム 進め る (F) 
1 フレ ー ム 戻す (B) 


y キー ボー ド シ ョ ー ト カッ ト を 無効 





c00 


特殊 キー の 入力 を 処理 する 





flash.ui.Keyboard ク ラス の プロ パテ ィ に より 、 capsLock、 numLock キ ー が 現在 アク ティ ブ 
に な つて いる か を 識別 で きま す 。 また 、 同 ク ラス に は スペ ー ス キー や Enter キ ー な ど 、 文字 コー ド 
で は な く キ ー コ ー ド で 識別 する 際 に 使用 で きる 定数 が 用 意 さ れ て いま す 。 capsLock、 numLock 
キー を ActionScript で アク ティ ブ / 非 アク ティ ブ に 変更 する こと は で きま せん 。Keyboard ク ラ 
ス の プロ バテ ィ と 定数 は すべ て 静 的 で 、 イ ンス タン ス を 生成 する 必要 は あり ませ ん 。 


特 Keyboard クラ ス の 特殊 キー マウ スイ ベン ト に 関す る プロ パテ ィ 


CapSLOCK true : 現在 CapsLock キ ー が アク ティ ブ で す 。 
: Boo]ean false : 現在 CapsLock キ ー が 非 ア クティ ブ で す 。 
読み 取り 専用 で 、 値 を 変更 する こと は で きま せん 。 


true : 現在 NumLock キ ー が アク ティ ブ で す 。 
false : 現在 NumLock キ ー が 非 ア クティ ブ で す 。 
読み 取り 専用 で 、 値 を 変更 する こと は で きま せん 。 





















capsLock キ ー が アク ティ ブ か 













numLock キ ー が アク ティ ブ か 






等 Keyboard クラ ス の 特殊 キー の キー コー ド を 表す 定数 


eee- | 束 
32 
13 









er- jmm js 
Leooxf- lmeewee js 


テン キー の 次 の キー 

NUMPAD_ADD 
NUMPAD_DECIMAL 
NUMPAD_DIVIDE 
NUMPAD_ENTER 
NUMPAD_MULTIPLY 
NUMPAD_SUBTRACT 
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7-3 
イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 


符 Keyboard ク ラス の 特殊 キー の キー コー ド を 表す 定数 (続き ) 


| 目的 の キー | 旨 | キー コー ド 値 



















































































| PageDown キ ー PAGE DOWN 34 
PART | PageUp キ ー 。 | PAGE_UP |ss ' 

| Shift キ ー | SHIFT ーー | 6 ー 
Tab キ ー 「 | TAB | ' | 9 

| 矢印 キー の 上 (1) 。 lop 。 | s8 上 
矢印 キ - の 下 (1) 。 |powN ーー |40 

| 矢 還 キー の 左 (ご ) luEFT " 37 ーー 

| 矢印 キー の 右 ( つ ) 。。 | ReHr |s9 











ーー 











ー InteractiveobjectSampleC.swf 
ファ イル (FE) 表示 (V) 局 御 (CO デバ ッ グ (D) 





ら AMPLE ビ ロ ロ ヒ EEEEEEEEEEEEEEEEHEEEEEEEkkdkd 


特殊 キー を 識別 する IntractiveUbjectSamplet.fla 
1mpor F1ash .u1 . KeyboarQd: 
/ / ス テー ジ で キー ボー ドイ ベン ト を 取得 する た め の イ ベン ト ハ ンド ラ の 登録 
gtage . addEventListener( KeyjboardEvent .KEY_DOWN, 8howKey ): 
/ /KeyboardEvent を 処理 する 人 ハン ドラ 
function showKey ( event : KeyjboardEvent ) :vo1d { 
char xt .text = String.FromCharCode ( event . keyCOode か 
/ / keyCode の 表示 
keycode tx 上.text = eVent .keyCoQde . toStrind() : 


0Z 


7-3-4 
特殊 キー の 入力 を 処理 する 


/ / 文字 の アル ファ 値 を 元 に 戻す 
a1t txt.alpha = 0.3: ghift txt .a1pha = 0.3: otr1 txt.a1pha = 0.3: 
/ /A1t キ ー の 判定 
1f ( event.a1tKey ) { 

a1t txt.alpha = 100: 
) 
/ / Shift キ ー の 判定 
if ( event.shifFtKey ) { 

8hift txt.a1pha = 100: 
) 
/ /Ct 上 r エ 1 キー の 判定 
if ( event.ctr1Key ) { 

Ctr」 txt.a1pha = 100: 
3 
/ /keyLocation の 判定 
key1ocat1on xE .tex = event .keyLooation . toString ( ) : 
/ / 特殊 キー (スペ ー ス 、Emnter) の 判定 
8BDGC よ & よ 上 7 。 も eKE = 『": 
Switch( event .keyCode ) { 

Ca8e Keyboard . SPACE : 

Spec1al xt .tex 上 = "Spaoe" :break : 
Ca8e Keyboard . ENTER : 
8DeC1a] xt .tex 上 = "Enter":break : 


) 


checkSpeoia1Keys ( ) : 


) 


//capsLock, numLiock キ ー の 判定 
Funmct1on CheokSpeocia1Keys ( ) :Yo1d { 一 ーーーーーーーーーーーーーーーーーーーーーーーーー- (②) 
CapS1ock 上 xt . ゞ Y1g1ib]le = Keyboard . capsLock : 


numlock Ex . ゞ 1g1b]e = Keyjboard . numLiock : 


) 
/ / 初期 値 は 非 表 示 に する 
Cap81ock xt .Y1sible = fa]sge: 


numlOck 上 xt . ゞ 1s1b]e = fa]se: 


護 度 農 の け サン プル で は スペ ー ス キー や Enter キ ー な どの 特殊 キー は 表示 され ませ ん 。 こ こ で 
は Keyboard ク ラス の 定数 に より 、charCode を 判定 し 、 ス ペー スキ ー と Enter キ ー の 場合 、 文 
子 を 表示 し ます 。 判定 は ① で 行っ て いま す 。 ま た 、capsLock キ ー と numLock キ ー が 押さ れ て 


いる か を ② か ら 始 まる checkSpecialKeys() 関 数 で 判定 し て いま す 。 203 


Tab に よる フォ ー カ ス 移 動 を 制御 する 





PART 表示 オブ ジェ クト に 対す る フォ ー カ ス の 変化 に 関す る 処理 を 行う た め の 仕 組み も 、Display 
Object ク ラス を 基本 クラ ス と する InteractiveObject ク ラス で 提供 され ます 。 イ ンタ ラク ティ 
ブ な 操作 を 行う DisplayObjectContainer、SimpleButton、TextField、Loader、Sprlte、 
Stage、MovieClip な どの クラ ス は すべ て InteractiveObject を 基本 と し て 作成 され て いる た 
め 、 フ ォ ー カ ス に 関す る イベ ント 処理 は 共通 に な り ま す 。 ま た 、DisplayObjectContainer ク 
ラス に は 子 オ ブ ジ ェクト が Tab に よる フォ ー カ ス を 受け る / 受 け な い を 決定 する tabChildren ブ 
ロ パ ティ が あり ます 。 


筆 InteractiveObject ク ラス の フォ ー カ ス に 関す る プロ バテ ィ 詳 細 


導 プロ パテ ィ の 詳細 


FocusReot オブ ジェ クト が フォ ー カ ス を 受け た と き に その こと を 示す 枠 を 表示 する か を 決定 し ます 。 
: Boo1ean 次 の 2 つの チェ ッ ク ボ ックス で は 、 下 の オ ブ ジ ェクト が フォ ー カ ス 梓 を 表示 し て いま す 。 


| | doubleClickEnabled( ダ プル ウリ ッ ウ イ ベン ト を 受取 る ) 


| IV| mouseEnabled( マ ウス イベ ント を 受取 る ) 





true : フォ ー カ ス 枠 を 表示 し ます (デフォルト ) 
false : フォ ー カ ス 枠 を 表示 し ませ ん 。 


EabEnab1ed | オブ ジェ クト が Tab キ ー に よる フォ ー カ ス 移 動 順序 に 含ま れる か を 決定 し ます 。 
: Boolean true : オブ ジェ クト は タプ ブ 移動 順に 含ま れ ま す ( 次 の ケー ス で デフ ォ ル ト 値 =true で す )。 
・SimpleButton オ ブ ジ ェクト 
・TextField で type = "input' の 場合 
・Sprite/MovieClip オ ブ ジ ェクト で buttonMode=true の 場合 
false : オブ ジェ クト は タブ 移動 順に 含ま れ ま せん 。( 上 記 の ケー ス 以 外 で は デフ ォ ル 
ト 値 = false で す ) 


Tab キ ー に よる フォ ー カ ス 移 動 順序 を 決定 する 整数 値 で す 。 値 が 小さ い ほ ど フ ォ ー カ 
ス を 受け る 順序 が 早く な り ま す 。 デ フォ ルト 値 は -1 で 、Tab イ ン デ ックス が 設定 され 
て いな いこ と を 表し ます 。 ア プリ ケー ショ ン 内 の すべ て の 表示 オブ ジェ クト の tab 
Index が デフ ォ ル ト 値 の 場合 、 自 動 的 に タプ 移動 順 が 割り 当て られ ます が 、1 つ で も 
tabIndex 値 が 設定 され た オブ ジェ クト が ある と 、 自 動 タ プ 移 動 順 は 無効 に な り 、tab 
Index に 値 が 設定 され た オブ ジェ クト だ けが Tab キ ー に よる フォ ー カ ス 移 動 の 対象 と な 
り ま ま 。 
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ーー9 
Tab に よる フォ ー カ ス 移 動 を 制御 する 


き InteractiveObject ク ラス の 主 な イベ ント 詳細 








イベ ント 名 イベ ント の 詳細 
(下段 : FocusEvent ク ラス 定数 ) 



















FocusTn オプ ジェ クト が フォ ー カ ス を 取得 し て ハイ ライ ト さ れる と き | 








FOCU: に focusin イ ベン ト が 発生 し 、 フ ォ ー カ ス を 衰 失 し た 後 、| 

keyFocusChangf focusOut イ ベン ト が 発生 し ます 。 

IT FOCuU8 じ hanqd6e オブ ジェ ク ト が 現在 フォ ー カ ス を 持っ て いて 、 ユー ザ の キー 
ee NR ー | ボー ド 操 作 に より フォ ー カ ス を 失 お うと する と き は keyFoc 

FOCUS OUT | USChange イ ベン ト が 発生 し ます 。 そ の 後 フ ォ ー カ ス を 失っ 

KEY FOCUS CHANGE た 後 は focusOut イ ベン ト が 発生 し 、 フ ォ ー カ ス を 得 た オブ 





MOUSE FOCUS CHANGE | ジェ クト で focusIn が 発生 し ます 。 

















き DisplayObjectContainer ク ラス の フォ ー カ ス に 関す る プロ バテ ィ 詳 細 














プロ パテ ィ プロ パテ ィ の 詳細 
tabChildren DisplayObjectContainer オ ブ プ ジ ェ クト が 持つ 子 オ ブ ジ ェクト が Tab に よる 
Boolean フォ ー カ ス を 受け る か 、 受 け な い か を 決定 し ます 。 | 
true : フォ ー カ ス を 受け ます (デフォ ルト )。 
| false : フォ ー カ ス を 受け ませ ん 。 








に | 良 画 コ 粒 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


っ InteractiveObjectSampleD.swf トル g- 販 
ファ イル (F) 表示 (y) 吊 御 (CO デバ ッ グ (D) 








WC で offcer... 


DC で TIfi1Ai で Hi 


も 4 LOO 





ツ focusRect On/Off ツ iabEnabled On/OTf 


= た 妥 目 = 才 本 mlp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


DisplayObject の フォ ー カ スプ ブロ パテ ィ と イベ ント InteractiveUbjectSampleD.Ha 


Var 1:11n 七 : 


/ /tabTIndex を 設定 


Funoction setTabTIndex ( ) :Yoid { 


と 05 


7-3 
イン タラ クティ ブ オ ブ ジ ェクト (InteractiveObject) 


す 1 .tabTndeXx=1 : 
す 2 . 上 abTnQdG メ =2 : 
3 . 上 abTndeX=3 : 
PART 4 .tabTndex=4 : 


/ /MovieC1 ip に tabEnab1ed, EocusRect 上 , イベ ント ハン ドラ を 設定 
Funotion setEventHand1 er ( ) :Yo1d { 
0 人 ま 電 生 : まま る 生生 た 季 WW す 4 
this[ "g" + 1 ] .addEventLi1stener ( FocusEvent . FOCUS IN, setFoCsg ): 
this[ "q" + 1 ] .addEventLiistener ( FocusEvent . FOCUS_OUT, setFosg ): 
) 
getTabEnab]ed chk .adQdEventLigstener ( Event .CHANGE, setTabEnabled ): 
getFoocusRect chk .addEventL1gtener ( Event .CHANGE , getFocugsRect ) 
setTabEnabled chk .tabEnabled = false: 
getFoousReot chk .tabEnabled = fal8e: 


/ /tabEnabed プ ロ パ ティ の 設定 
Function setTabEnab1edSettings ( enab1eTab : Boo1ean ) :void { 
or 《( ま w3 / る も <m4 を 7) tr+)8 


this[ "q" + 1 ] .tabEnab1ed=enab1eTab : ① 


//fEocusRect プ ロ パ ティ の 設定 
Function setFocusRectSettings ( enab1eRect : Boo1ean ) :void {1 
を ( よ ま よ ぁゃ 1 も 32 1 ce 4 : も Mr) 


thig[ "q" + 1 ] .EoCusRect=enab1eReCct : ② 


//tabEnabed On/OEF チ ェ ッ クボ ックス の イベ ント ハン ドラ 

Function setTabEnab1 ed ( event : Event ) :o1d { 
setTabEnab1edSettings( setTabEnabled chk.selected ): 
//tabEnab1ed = false, に より 、fFocusRect も fa1lse に な る た め 、true に 戻し ます 
if ( setFocusRect ohk.selected ) setFocusRectSet ュ ngS ( 


setFoousRect chk.seleoted ): 
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ゲー は ー- ら 5 
Tab に よる フォ ー カ ス 移 動 を 制御 する 


//fEocusRect On/OEfF の イベ ント ハン ドラ 
Funotion setFoousReot (event : Event ) :vo1d { 


SetFoOCuSRecCtSet1ngs ( setFocusReoct chk.selected ): 


//focusTn / focusOut の イベ ント ハンドラ 
Funct1on SetFoCg( even :FOCu8EVent ) :Yo1d | 
gw1toh ( event .type ) { 
Ca8e FOCuSEVent .FOCUS TIN : 
eVen .tarqdet .a1pha=0 .2: 
break : ③ 
Ca8e FOCUSEVent . FOCUS_OUT : 
eVent .tarqdet .a1pha=1 . 0: 


breakK : 
! d 


/ / 初期 呼び 出し 

setTabTndex ( ) : 
setEventHandler () : 
setTabEnabledSettings( true ): 


getFocu8RectSet て inggs ( rue ): 


6 つの ムー ビー クリ ッ プ の うち 、 右 側 の 4 つ に 対し て 、 タ ブ で フォ ー カ ス 移 動 す る サン プル で 
す 。 画面 下部 の focusRect On/Of チ ェ ッ クボ ックス で focusRect、tabEnabled On/Off 
チェ ッ ク ボ ックス で tabEnabled プ ロバ パテ ィ の 変更 を 行い ます 。 そ れ ら は で 4 つの ムー ビー ク 
リッ プ の tabEnabled プ ロバ パテ ィ を 、⑫ で focusRect プ ロ パ ティ を 設定 し て いま す 。③ で focu 
sIn, focusOut イ ベン ト の 処理 を 行い フォー カス を 得 た ムー ビー クリ ッ プ の アル ファ 値 を 下 
げ て いま す 。 こ こ で は 、event.type で イベ ント の 種別 を 判定 し て いま す 。 こ の サン プル を ムー 
ビー プレ ビュ ー す る と き は 、[ 制 御 ]-[ キ ー ボ ー ド ショ ー ト カッ ト を 無効 メニ ュー に チェ ッ ク を 
つけ ます 。 
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7 - 4 FocusManager 
IE1UETIEL【 は 胡 : ス ト コル 





PART 
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Tab 移 動 順 に よる フォ ー カ ス 移 動 で は な く 、ActionScript に よる フォ ー カ ス の 制御 を 行う 場 
合 は FocusManager ク ラス を 使用 し ます 。FocusManager は DisplayObjectContainer 単 位 
で 、 含 まれ る 子 オ ブ ジ ェクト を グル ー プ 化 ( タ ブ グ ルー プ ) し て フォ ー カ ス 管 理 す る こと が で き 
ます 。 例 えば DisplayObjectContainer コ ン テ ナ が 2 つ あ る 場合 、2 つ の FocusManager オ ブ 
ジェ クト を 作成 し 、 そ れ ぞ れ で コン テ ナ に 含ま れる 子 オ ブ ジ ェクト グル ー プ の フォ ー カ ス 制 御 
を 行う こと が で きま す 。getFocus() メ ソ ッ ド で 現在 フォ ー カ ス を 持っ つて いる オブ ジェ クト を 取 
得 で を ます 。 ま た プロ グラ ム で フォ ー カ ス を 移動 する に は 、setFocus() メ ソ ッ ド を 使用 し ます 。 


衝 FocusManager ク ラス の 主 な プロ バテ ィ 


BN 


デフ ォ ル ト の ポ ボタン を | defau1EtButEon 現在 設定 され て いる デフ ォ ル ト ボ タン を 表し 


設定 / 取 得する ます 。 


デフ ォ ル ト の ボタ ン が | dsfau1EButtonEnab1ed | デフ ォ ル ト ボ タン の 有効 / 無 効 を 決定 し ます 。 
有効 か : Boo]ean 





特 FocusManager ク ラス の 主 な メソ ッ ド 


管理 する 対象 の Display コン スト ラク タ で す 。 引 数 に 対象 と する Disp 
ObjectContainer オ ブ ジ layObjectContainer オ ブ ジ ェクト を 指定 し 
ェクト を 指定 する ます 。 











OCUSMana ロ er | 







COonta1ner : 
D1splayOb] ec 
Conta1ner 






FocusManager イ ンス タン ス を アク ティ ブ / 
非 ア クティ ブ に し て フォ ー カ ス 制 御 を 行え る 
よう に し ます 。 


現在 フォ ー カ ス を 持っ て いる オブ ジェ クト を 
取得 し ます 。 


Tab キ ー に より 、 次 に フォ ー カ ス を 受け る オブ 
ジェ クト が ある 場合 、 取 得 で きま す 。 





FocusManager を アク テ 
ィ ブ / 非 アク ティ ブ に する 


フォ ー カ ス を 持っ て いる | getFocug 
オブ ジェ クト を 調べ る 


Tab キ ー で 次 に フォ ー カ 
ス を 取得 する オブ ジェ 
クト を 調べ る 


























etNexx1 
cOmDOn ら 61 
backward : BOolean = 
Fa186 

) : Tn 上 GraC 上 ュ び GOD] ec 


アメ オー カス イシ ジ シ ジ ケ ー | de 
タ を 削除 / 表 示す る ShOwE 


指定 し た オブ ジェ クト 
に フォ ー カ ス を 移す 












現在 フォ ー カ ス を 持っ て いる オブ ジェ クト が 
イン ジ ケ ー タ を 持つ 場合 、 削 除 / 表 示し ます 。 


指定 し た オブ ジェ クト に フォ ー カ ス を 移し ま 
す 。 














COmpOonen : 
Tn キ tGraC 上 1 ュ び eOD] @GC 
: VO 〇 1d 
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FocusManager を 使う 
符 FocusManager ク ラス の フォ ー カ ス 移 動 / 取 得 に 関す る メソ ッ ド 詳細 
メソ ッ ド メソ ッ ド の 詳細 」 
jetF FocusManager が 管理 する InteractiveObjectContaine 
: T ロ 上 6G エ aC ヒ 1 D] @ r「 イ ンス タン ス の 中 で 、 現 在 フ ォ ー カ ス を 持っ て いる オ 
ブ ジ ェクト を 返し ます 。 
ge Component : Tnteractive | パラ メー タ で 指定 し た オブ ジェ クト に フォ ー カ ス を 移し 
Object ます 。 
jeELNextFocusManagderComponen1 Tab キ ー を 押し た と き に 次 に フォ ー カ ス を 取得 する オブ 
backward : Boo1ean = false) : ジェ クト が あれ ば 、 そ の オブ ジェ クト を 返し ます 。 次 の 





FaCt1VeOb]@Ct 有効 な オブ ジェ クト が な い 場 合 、 現 在 フ ォ ー カ ス を 持っ 
た オブ ジェ クト が 返さ れ ま す 。 「 














= 中 衣 画 ヨ 蘭 - ---------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 








InteractiveObjectSampleE.swf |-ー-| 豆 -| 革 宙 
ファ イル (P) 表示 (y) 事 御 (CO デバ ッ グ (D) 





W で offer..、. 


0 


D で YA で YYN【 


{計り 1 





= 中 衣 画 コ 首 mmlp】 ヨ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


FocusManager オ フジ ェクト で フォ ー カ ス を 移動 / 取 得する Interactive0bjectSamnieE.fla 


1mport 革 ] .manaqer8 .FOCuSManader : 


Var fcC1 :FOCu8Manader : 


Va 1 ユ :1n : 
/ / FocusManaqder オ ブ ジ ェクト を 生成 


Function initFo ( ) :void { 


FcC1=mnew FoOCusManader (th18) : ーーーーーーーーーーー ーー (1 
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7-4 
FocusManager 


/ /tabTndex を 設定 
function setTabTndex ( ) : vo1d {1 
bu 上 て ton1 . 上 abTnQdeX=1 : 
bu 上 上 on2 .t 上 abTndex=2 : 
jpu 人 ton3 . tabTnQdeX=3 
button4 .tabTnQdex=4 : 


/ /MovieC1 ip に tabEnab1ed, FocusRect 上 , イベ ント ハン ドラ を 設定 
Funotion setEventHand1] er ( ) : vo1d { 
for (1 = 1: 1 <= 4: i++) { 
thisg [ "button"+ ュ 1] .addEVentL1gtener( FoOCusEvent .FOCUS TIN, setFeoCsg ): 
thig [ "button"+ ュ 1] .adQdEventL1stener( FoCusEvent . FOCUS _OUT, setFocg 
) 


/ /tabEnabed プ ロ パ ティ の 設定 
Function setTabEnab1edSettings( enab1eTab : Boo1ean ) :vo1d { 
for (1 = 1: 1 <= 4: ユ ++) 1{ 


thig [ "button"+ ュ ] .tabEnabled=enableTab : 


//EocusRect プ ロ パ ティ の 設定 
Function setFocusRectSettings ( enab]1eRect : Bool1ean ) :vod { 
for (1 = 1: 1 <= 4: 1++) { 


thig [ "button "+ ュ ] .Focu8Rect=enab1eRec : 


//fEocusTn / focusOut の イベ ント ルン ドラ 
Funotion setFos ( event : FocusEvent ) :vo1d { 
switch ( event .type ) { 
Ca8e FOCu8Event .FOCUS IN : 

eVent .tarqdet .a1pha=0 .2: 
/ /FocusManagder オ ブ ジ ェクト の メソ ッ ド を 使用 し て 現在 の フォ ー カ ス オ ブ ジェ クト を 取得 
etFocCuS8 上 xt .tex キ =fFoc1 .detFOCug ( ) .name : 
//FocusManager オ ブ ジ ェクト の メソ ッ ド を 使用 し て 次 の フォ ー カ ス オ ブ ジェ クト を 取得 


⑯ 


プー4- 1 
FocusManager を 使う 


nextTabTndex tx .Eext = foc1 .detNextFoCusManaderComponent ( ) . 
mae : (② 
break : 

Ca8e FOCuSEVernt . FOCUS_OUT : 
eVent .tarqdet . a1pha=1 . 0: 


breaKk : 


/ / 初 期 呼 び 出し 

1n1tFo ( ) : 

getEventHandler ( ) : 
8etTab1Index ( ) : 
setTabEnab1edSettings( true ): 


SetFocusRectSettinqgs( true ): 


/ /jbutton1 に フォ ー カ ス を 移し ます 
fc1 . getEFOCu8 ( Du 上 on1 ) : 一 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ③ 


「Tab に よる フォ ー カ ス 移 動 を 制御 する ] の サン プル を 修正 し て FocusManager を 使 
用 し ます 。6 つ の ムー ビー クリ ッ プ の うち 、 右 側 の 4 つ に 対し て 、 タ ブ で フォ ー カ ス 移 動 す る サ 
ン ブ ル で す 。 い ひで FocusManager オ ブ ジ ェクト を 作成 し て いま す が 、 コ ンス トラ クタ に 管理 対 
家 と する DisplayObjectContainer オ ブ ジ ェクト を 渡す 必要 が あり ます 。 画面 下部 に getFoc 
us() メ ソ ッ ド に よる 現在 フォ ー カ ス を 持つ オブ ジェ クト 、getNextFocusManagerCompone 
nt() メ ソ ッ ド に より 、 次 に フォ ー カ ス を 持つ オブ ジェ クト を それ ぞ れ 取得 し て name プ ロ パ ティ 
を 表示 し ます 。 こ れ は ⑫ の focusiIn イ ベン トル ハン ドラ で 行っ て いま す 。⑬ で setFocus() メ ソ ッ 
ド を 使用 し て フォ ー カ ス を button1 に 移し て いま す 。 こ の サン プル を ムー ビー プレ ビュ ー す る 
と き は 、[ 制 御 ]-[ キ ー ボ ー ド ショ ー ト カッ ト を 無効 メニ ュー に チェ ッ ク を つけ ます 。 


e1 1 


Enter キー に 反応 する デフ ォ ル ト 
ポタ ン を 作成 する 


PART 入力 フォ ー ム な ど で 、Enter キ ー を 押し た と き に 送信 ボタ ン が 押さ れる よう な 処理 を 行い た 
い 場 合 、 デ フォ ルト ボタ ン を 設定 し ます 。FocusManager ク ラス に は デフ ォ ル ト ボ タン を 設 
する た め の defaultButton プ ロバ パテ ィ が あり ます 。 





符 FocusManager ク ラス の デフ ォ ル ト ポ ボタ ン に 関す る プロ バテ ィ 詳 細 
プロ パテ ィ プロ パテ ィ の 詳細 


lefau1 上 Butto FocusManager イ ンス タン ス が 管理 する タブ グル ー プ 内 で デフ ォ ル ト ボ タ 

: Button ン を 設定 / 取 得 し ます 。FocusManager オ ブ ジ ェクト は 、Enter キ ー が 押さ 
れ た と き 、 フ ォ ー カ ス を 持っ て いる コン ポー ネン ト で は な く 、 こ の プロ パ 
ティ で 設定 され た ボタ ン に 対し て click イ ベン ト を 送出 し ます 。 こ の 処理 は 
フォ ー カ ス が Button コ ン ボ ポー ネン ト に ある と き は 行わ れ ま せん 。 


デフ ォ ル ト ボ タン を 有効 / 無 効 に し ます 。 

true : FocusManager は Enter キ ー が 押さ れ た 場合 、 設 定 さ れ た デフ ォ ル 
ト ボ タン に click イ ベン ト を 送出 し ます 。 

false : FocusManager は Enter キ ー の 入力 を 監視 せ ず 、 デ フォ ルト ボタ ン 
に click イ ベン ト を 送出 し ませ ん 。 


プ InteractiveObjectSamplsF.swf 


ファ イル (F) 表示 (y) 制御 (OO デバ ッ グ (D) 





= た 1 画 コ 首相 mp】 ヨ 蘭 ----------------ー-ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


デフ ォ ル ト ボ タン の 設定 interactive0bjectSampieFila 


1mDpor F] .manaqer8 .FoCusManader : 
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7-4-2 
Enter キ ー に 反応 する デフ ォ ル ト ボ タン を 作成 する 


Var 上 で C1 :FOCusManadeTr : 


/ /FocusManagder オ ブ ジ ェクト を 生成 し 、 デ フォ ルト ボタ ン の た め の 設 定 を 行い ます 
Function nitFo( ) :vo1d { 

Fc1=new FocusManaqder (h18) : 

Fc1 .defaultButtonEnabled = 上 上 了 エ UG: 

Fc1 .defau]tButton =this .defau] 上 Dutton: 


defaul て button .tabEnabled = fal]8se: 
defau1t Du て on . addEVentL1stener (MouseEvent .CLTCK, defau] 
ButtonClicked ): 

/ / デ フォ ルト ボタ ン が 押さ れ た と き の 如 理 

Function defau1tButtonC]ioked ( event :MouseEvent ) :void { 
traoe ( 『 登 録 ボ タン が 押さ れ ま し た 。" ): ーーー 和 O 


/ /tabTndex を 設定 

Function setTabTndex ( ) :vo1d { 
name 上 xt . 上 abTnQdex=1 : 
Pa88wOorQ txt .taDTnde メ =2 : 


/ / 初期 呼び 出し 
1nitFoC() : 
setTabTndex ( ) : 


Fc1 .getFocus( name tx ): 


入力 フォ ー ム の サン プル で す 。2 つ の TextInput コ ン ポ ボー ネン ト を 配置 し て お り 、① の 関数 で 
FocusManager に より 、 登 録 ボ タン を デフ ォ ル ト ボ タン に 設定 し て いま す 。 こ の 設定 に より 、 
TextInput に フォ ー カ ス が ある と き に Enter キ ー を 押す と 、 こ の ボタ ン の click イ ベン ト が 発生 
し ます 。 サ ンプ ル で は 、② の ハン ドラ を 登録 し て いる の で 、trace() 関 数 が 実行 され ます 。 こ の 
サン ブ プル を ムー ビー プレ ビュ ー す る と き は 、[ 制 御 ]-[ キ ー ボ ー ド ショ ー ト カッ ト を 無効 ] メ ニュ 
ー に チェ ッ ク を つけ ます 。 
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7 ー5 MovieClip 
MovieClip を 使う 





ActionScript1.0、2.0 で は 、 表 示 エ レ メ ン ト は すべ て MovieClip ク ラス で 管理 し て いま し た 
が 、ActionScript3.0 で は 、Flash Player の ステ ー ジ に 表示 され る ビジ ュ ア ル エ レ メ ン ト は す 
べ て DisplayObject ク ラス を 基本 と する クラ ス で 、MovieClip ク ラス は タイ ムラ イン を 持つ 表 
示 オ ブ ジ ェクト コン テ ナ と し て 位置 づ ひ られ て いま す 。 そ の た め 、MovieClip ク ラス が 持つ 特 
有 の 機能 と し て は タイ ムラ イン に 関す る 操作 が 中 心 に な り ま す 。 


乱 MovieClip クラ ス の 主 な プロ パテ ィ 概 要 


プロ パテ ィ 名 プロ パテ ィ の 概要 


現在 再生 ヘッ ド が 位置 する フレ ー ム の 番号 を 表し 
ます 。 


現在 肌 生 ヘッ ド が 位置 する フレ ー ム の ラベ ル を 表 
し ます 。 













再生 ヘッ ド が ある フレ ー 
ム の 情報 を 得る 








ご C い エエ Gn ロ 七 ド エコ me 
[abe : S 上 r1nqd 
C い エエ YentTaDe」 

: GS 上 1md 











Cu エエ Gn 七 Cen@G 





現在 再生 ヘッ ド が 置か れ て いる シー ン を 得る こと 
が で きま す 。 





:・ Cen@ 


現在 の シー ン を 得る 

























現在 の シー ン に ある ラベ | currentTLiabe]g 現在 の シー ン に 存在 する ラベ ル の リス ト を Frame 
ル を 得る : 人 A エ エ a ツ Label オ ブ ジ ェクト の 配列 で 取得 し ます 。 









enab1edQ 


: Boolean 










false の 場合 、 ムー ビー クリ ッ プ の 「 オ ー パ ー」、「 ダ 
ウン 」、「 ア ッ プ 」 の 各 フ レー ム は 無効 に な り ま す 。 


ボタ ンタ イプ の ムー ビー 
クリ ッ プ を 有効 / 無 効 に 
する 


読み 込み 済み フレ ー ム 数 
を 取得 する 


Loaderlnfo オ プ ジ ェ ク 
ト に アク セス する 















スト リー ミン グ SWF の 読み 込み 済み フレ ー ム 数 を 
取得 で きま す 。 
[DisplayObject ク ラス ] 


ファ イル の 読み 込み 情報 を 提供 する LoaderlInfo オ 
ブ ジ ェクト へ の アク セス を 提供 し ます 。 


Frame8Loaded 
: ユヒ 

























1 OaQer Tn 人 TO 
: OoaderTnfOo 



















ムー ビー クリ ッ プ 内 の す 
べ て の シー ン を 取得 する 


MovieClip イ ンス タン ス 内 の シー ン の 名 前 、 フ レ 
ー ム 数 、 フ レー ムラ ベル が リス ト さ れ た Scene 
オブ ジェ クト の 配列 を 得る こと が で きま す 。 










MovieClip イ ンス タン ス 内 の フレ ー ム の 総数 を 得 
る こと が で きま す 。 framesLoaded プ ロ パ ティ と 
合わ せ て 使用 する と 、 何 パー セン ト の フレ ー ム を 
読み 込み 済み か を 判定 で きま す 。 


世 O 〇 巧 a1F エ ameg 


・ ユリ 上 





ムー ピー の サッ プ の の う 
レー ム 数 を 取得 する 














7- ら 5-1 
MovieClip を 使う 


特 MovieClip クラ ス の 主 な メソ ッ ド 概要 


指定 フレ ー ム か ら 再 生 を 開 フレ ー ム 番号 また は フレ ー ム ラベ ル を 指 
始 す る 定 し て 再生 を 開始 し ます 。 





qoOtoAnQdPlay( 
Frame : Ob] ec , 
8Cene : St エエ 1nd = nu]l1 
) :VO1d 



























指定 フレ ー ム に 再生 ヘッ ド 
を 移動 する 








qOtOAnQdSEtOD ( 
Frame : Ob] ec , 
8Cene : S 上 エエ 1nd = nu]1 
) : ざ O10d 


次 / 前 の フレ ー ム に 移動 する | nextFrame ( ) :Void 
PreVF エ ame ( ) :VO1d 


次 / 前 の シー ン に 再生 ヘッ ド 
を 移動 する 


再生 を 開始 / 停 止 する 


フレ ー ム 番号 また は フレ ー ム ラベ ル を 指 
定 し て 、 そ こ に 再生 ヘッ ド を 移動 し て 停 
止 し ます 。 






















次 / 前 の フレ ー ム に 再生 ヘッ ド を 移動 し て 
そこ で 停止 し ます 。 


次 / 前 の シー ン に 再生 ヘッ ド を 移動 し ます 。 










nextSCene ( ) :VO1d 
DreVvScene ( ) :VO1d 

















play () :VO1d 
StOD ( ) :VO1d 


ペー ビー クルッ プス オナ ジュ タ ト の ダイム 
ライ ン 再 生 を 開始 / 停 止 し ます 。 





2 
ご MoviedipsampleA sw 
ファ イル (F) 表示 (y) 制御 (CO デバ ッ グ (D) 





AMPLE ロロ DE 還 滞 EE 二 


MovieClip オブ ジェ クト の 情報 を 調べ る MovieClipSampleAla 


//1oaderTnfEo を 取得 し て イベ ント リス ナー を 登録 
this . 1]oaderTnfo .addEventL1 st 上 ener (PrOodressEVenrt . PROGRESS , 
progre88Harid1er ) : 一 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー① 
Function progressHand1er (event : ProdregsEvent ) :Vo1d { 
this .proqgres8 xt .appendText ("メイ ンタ イム ライ ン : 『" + 
this . framesLoaded + "フレ ー ム ロー ド 済 / " + this .tota1Frame8 + ②⑨ 
"フレ ー ム 中 \n" ): 
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MovieClip 
this .prodres8 Ext .appendText ("movie mC: " + 
this .movie mo.fFramesLoaded + "フレ ー ム ロー ド 済  / "+ ③ 


this .movie mo.tota1Frames + "フレ ー ム 中 \n"  ): 
th1gs .prodreSsg8 xt .appendText( thigs.1oaderTnfFo.bytesLoaded + の 
ゅ バイ トロ ー ド 済 / " + this.1oaderTnfo.bytesTota1 + "バイ ト 中 \n"  ): 


① の 「this.IoaderInfo] と いう 記述 で この ムー ビー の ロー ド 情 報 を 持つ Loaderlnfo オ ブ ジ ェ 
クト を 取得 で きま す 。 こ の オブ ジェ クト は 読み 込み 状況 を 更新 する た め の progress イ ベン ト を 
発生 し ます 。 そ の ハン ドラ で 現在 の 読み 込み 状況 を 把握 で きま す 。(② で は メイ ンタ イム ライ ン 
の フレ ー ム 数 (totalFrames) と 、 ロ ー ド 済み フレ ー ム 数 (framesLoaded) を 取得 し 、(3③ で は 
movie_ mc と いう ムー ビー クリ ッ プ の フレ ー ム 数 を 取得 し て いま す 。 ま た 、 フ ァイル の 総 バ イ 
ト 数 と ロー ド 済 み バ イト 数 は bytesTotal、bytesLoaded プ ロ パ ティ で 取得 で きま す が 、④ で 
それ ら を 使用 し て いま す 。 


MovieClip の 再生 と 停止 を 行 





タイ ムラ イン の 再生 と 停止 、 フ レー ム の 移動 な どの 操作 は MovieClip ク ラス の メソ ッ ド で 行 
いま す 。 複 数 の シー ン を 利用 し て いる 場合 、 シ ー ン 名 を 指定 し て 制御 を 行う こと が で きま す 。 


乱 MovieClip クラ ス の フォ ー カ ス の 移動 / 取 得 に 関す る メソ ッ ド 詳細 


gotoAndP]ay frame : この パラ メー タ で 指定 し た フレ ー ム 番号 / ラ ベル 文字 列 
(Frame :Ob]ect , scene : で 再生 を 開始 し ます 。 注意 と し て 、 現 在 の フレ ー ム に 未 実行 の 
St 上 ing=nu] 1 アク ショ ン が ある 場合 、 そ れ ら が 実行 され た 後に フレ ー ム の 移 
: Interact 上 iveOb] ec 動 が 行わ れ ま す 。 
scene : シー ン を 指定 し て 再生 を 制御 する 場合 、 シ ー ン 名 を こ 
の パラ メー タ に 設定 し ます 。 現在 の シー ン で 実行 する 場合 、 省 
略 可 能 で す 。 


JotoAndSto frame : この パラ メー タ で 指定 し た フレ ー ム 番号 / ラ ベル 文字 列 
(Frame :Ob]ect, scene : に 移動 し て 再生 を 停止 し ます 。 現在 の フレ ー ム に 未 実行 の アク 
S 上 1nd=nu1 1 ショ ン が ある 場合 、 そ れ ら が 実行 され た 後に フレ ー ム の 移動 が 
: InteraC 上 1VeOb] ct 行わ れ ま す 。 
scene シーン を 指定 する 場合 、 シ ー ン 名 を この パラ メー タ に 
設定 し ます 。 現在 の シー ン で 実行 する 場合 、 省 略 可能 で す 。 
次 の フレ ー ム に 移動 し て 再生 を 停止 し ます 。 現在 の フレ ー ム に 
未 実行 の アク ショ ン が ある 場合 、 そ れ ら が 実行 され た 後に フレ 
ー ム の 移動 が 行わ れ ま す 。 


再生 ヘッ ド を 再生 状態 に し て 次 の フレ ー ム に 移動 し ます 。 


前 の フレ ー ム に 移動 し て 再生 を 停止 し ます 。 現在 の フレ ー ム に 
未 実行 の アク ショ ン が ある 場合 、 そ れ ら が 実行 され た 後に フレ 
ー ム の 移動 が 行わ れ ま す 。 


前 の シー ン に 移動 し ます 。 現在 の フレ ー ム に 未 実行 の アク ショ 
ン が ある 場合 、 そ れ ら が 実行 され た 後に フレ ー ム の 移動 が 行わ 
れ ま す 。 


再生 ヘッ ド を 停止 状態 に し て 次 の フレ ー ム に 移動 し な いよ うに 
し ます 。 





4 』 


PART 


2168 


7-5 
MovieClip 


呈 A 人 PLE 琴 EEEEEEREREEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


ファ イル (F) 表示 (V) 記 御 (CO デバ ッ グ OD) 





呈 A 人 MPLE ビ ロ ロ E ESECEEEEEEEIEE 


再生 ヘッ ド の 制御 MovieClipSampieB.fla 


/ / 再生 、 停 止 ボ タン の イベ ント ハン ドラ 登録 
play btn .addEventListener( MouseEvent .CLTCK, qotoAnQdPlay_ ) の 
gtop btn .addEventListener( MouseEvent .CLhTCK, gotoAndStop_ ): 


/ /gotoAndP1ay を 行 つ 関数 
function gotoAndPlay ( event:Event ) :void { 

NOV も の WC、 go も GAndBLay( pEay Ga8:Yalue ) ーーーーーーーーーーーーーーーーー@ 
) 
/ /gotoAndStop を 行 つ 関数 
Function gotoAndStop ( event :EvenE ) :vod { 

0OW よ あ 。 T0G. GOEQOADSEOD ( REOB D.V1MG ) ーーーーーーーーーーーーーーーーー ぴ 
) 


① は ボタ ン ハ ンド ラ の 登録 で す 。② で は movie_mc に 対し て 、NumericStepper の 値 を フレ 


ー ム 番号 と し て 、gotoAndPlay() メ ソ ッ ド で 指定 フレ ー ム か ら 再 生 を 行い ます 。 (3 で は 、 同 様 
に gotoAndStop() メ ソ ッ ド に より 、 フ レー ム に 移動 し て 再生 を 停止 し ます 。 


【 い lg リリ アルラー リ / マ ヤー 
ンー ン 情 報 を 得る 





MovieClip オ ブ ジ ェクト が 持つ フレ ー ム と シー ン の 情報 は 、MovieClip ク ラス の プロ パテ ィ 
で 調べ ます 。 現 在 ど の フレ ー ム に いる か と いう 情報 も 得 ら れ ま す 。 


算 MovieClip クラ ス の フレ ー ム と シー ン 情 報 に 関す る プロ パテ ィ 詳 細 


プロ パテ ィ プロ パテ ィ の 概要 





再生 ヘッ ド 位 置 の 現在 の シー ン 内 で の フレ ー ム 番号 を 表し ます 。 他 の シー 
ン の フレ ー ム 数 は 含ま れ ま せん 。 













現在 の フレ ー ム に 設定 され て いる ラベ ル を 返し ます 。 ラ ベル が な い 場 合 、 
nul に な り ま す 。 


現在 の フレ ー ム に 設定 され て いる ラベ ル を 返し ます 。 ラ ベル が な い 場 合 、 
前 の フレ ー ム に ラベ ル が あれ ば その ラベ ル の 値 が 引き 継が れ ま す 。 前 の フ 
レー ム に も ラベ ル が な い 場 合 は null に な り ま す 。 
















現在 の シー ン が 持つ すべ て の フレ ー ム ラベ ル を 配列 で 取得 で きま す 。 各 ラ 
ベル の 情報 は FrameLabel ク ラス の イン スタ ンス と し て 保持 され ます 。Fra | 
meLabel ク ラス は 次 の 情報 を 持ち ます 。 


特 flash.display.FrameLabel ク ラス の プロ パテ ィ 


プロ パテ ィ 









name プ ロ パ ティ で 示さ れる ラベ ル が 設定 され た フ 
レー ム の 番号 


ラベ ル と し て 設定 され た 文字 列 











name : S 上 1nd 


現在 再生 ヘッ ド が ある タイ ムラ イン が 属し て いる シー ン 名 を 得る こと が で 
きま す 。 


MovieClip イ ンス タン ス 内 の シー ン の 名 前 、 フ レー ム 数 、 フ レー ムラ ベル が 
格納 され た Scene オ ブ ジ ェクト を 配列 で 返し ます 。Scene ク ラス は 次 の 情 
報 を 持ち ます 。 


香 flash.display.Scene クラ ス の プロ パテ ィ 


シー ン が 持つ すべ て の フレ ー ム ラベ ル を 配列 で 取得 で 
きま す 。 各 ラベ ル の 情報 は flash.display.FrameLabel 
クラ ス の イン スタ ンス と し て 保持 され ます 。 


シー ン 名 を 表し ます 。 


< シー ン 内 の フレ ー ム 数 を 表し ます 。 


MovieClip イ ンス タン ス 内 の フレ ー ム の 総数 を 表し ます 。 イ ンス タン ス 内 に 
復 数 の フレ ー ム が ある 場合 、 こ の プロ パテ ィ は 、 ム ー ビ ー ク リッ プ 内 の す 
べ て の シー ン の フレ ー ム 総数 を 表し ます 。 








































と 


PART 
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7-5 
MovieClip 


呈 AMPLE ERREEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEESE 


IT 
ファ イル (F) 表示 (y) 吊 御 ( 〇 O デバ ッ グ (D) 












framelnfo_txt 


frameLabellnfo_txt 


己 AMPLE ビ ロ ロ E EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


現在 の フレ ー ム 、 シ ー ン 情報 を 調べ る 骨 ovieCiipSampleCJla 


/ / 再 生 、 停 止 ボ タン の イベ ント ハン ドラ 登録 
play btn .addEventL1stener( MouseEvent .CLTCK, Play  ): 貞 0 
gtop btn .addEventListener( MouseEvent .CLTCK, StOD_ ): 人 
/ / P1ay を 行 つ 関数 
Funotion Play ( event :Event ) :void { 
moVie mo.play(): 
) 
/ / Stop を 行 つ 関数 
Function Stop ( event :Event ) :void { 


moV1e mo.8EOD () : 


) ② フ レー ム 番 号 
プル で 4 フッ 
mov1e mo.addEventL1stener( EVent .ENTER FRAME, 8howTnfo ) : 一 ル を 取得 し て テ 
キス ト フ ィ ー ル 
Function showTnfFo (event : Event) :vo1d { ド に 書き 出す 
FraneTnfo tx 上 .text = "現在 の フレ ー ム 番号 :" + moV1e _mC.CurrentFrame : 
EranerLiabe1Tnfo txt.text = 『 現 在 の フレ ー ム ラベ ル :『" + moV1e mo. 
CurrentFrameLabe] : ③ シ ー ン 数 と フレ 
ー ム 数 を 調べ る 
) 
nfo txt .text = "シー ン 数 : " + movie mc.sCene8 .1ength + " フレ ー ム 数 : 


! 二 mOV1e moC.tota1Frame8: 


この サン プル に 配置 され た コン テン ツ は ビデ オ を 30 フ レー ム の フレ ー ム ベー ス の アニ メー 
ショ ン と し て 再生 する も の で 、MovieClip の 名 前 は movie_mc、 そ の 各 フ レー ム に frame 
X (X は 1-30 の 数 値 ) と いう 名 前 が つけ られ て いま す 。 


ライ ブラ リシン ボル の 
イン スタ ンス を ステ ー ジ に 配置 する 





ライ ブラ リ 内 の Movieclip シ ン ボ ル の イン スタ ンス を ステ ー ジ に 配置 する 場合 、Display 
ObjectContainer ク ラス の addChild0 メ ソ ッ ド で 行う こと が で きま す 。 イ ンス タン ス の 生成 
は new 演 算 子 で 行い ます が 、 そ の と き に 使用 する クラ ス 名 は シン ボル を 作成 し た と き に つけ た 
シン ボル 名 に な り ま す 。 ま た 、 シ ン ボ ル に 変換 する と き に 「ActionScript 用 に 書き 出し 」 オプ 
ショ ン を 指定 し て お く 必 要 が あり ます 。 


答 ン ン ボル に 秋 換 ダイ アロ グ 
シン ボル に 変換 02222 
名 前 (N) : MyMovieClp 
タイ プ ① : | ムー ビー 多 ヶ プ <| 基準 点 (Di888 
フォ ル ダ : ライ ブラ リル ー ト 








9 スラ イス の 拡大 / 約 小 の た め の ガ イド を 有効 に する (⑥⑤) 


ActionScript 用 に 書き 出し 
メ 1 フルーム 目 に 書き 出し 


りう 2( 〇 : 請 員 Wa y ぴ 


基本 りう ラス : Fash.display.MovieClip マソ 


共有 
ラン タイ ム 共 有用 に er 
ンタ イム 共有 用 J 


ファ イル : 
シ ツン ボル 名 : ツン ポル 1 


ブリ ッシュ 前 に 常に 更新 





ダイ アロ グ で [詳細 ] ボ タン を 押し て 、「ActionScript 用 に 書き 出し 」 に チェ ッ ク を つけ て シン 
ボル に 変換 し ます 。 


m DisplayObjectContainer ク ラス の 子 オ ブ ジ ェクト 追加 / 削除 に 関す る プロ パテ ィ 詳 細 


プロ パテ ィ プロ パテ ィ の 詳細 


DisplayObjectContainer オ ブ ジ ェクト の 子 の 数 を 表し ます 。 読 み 取 り 専用 で 、 値 


を 設定 する こと は で きま せん 。 こ の プロ パテ ィ の 値 は addChild()、removeChild() 
な どの メソ ッ ド で 変化 し ます 。 
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プー る ち 
MovieClip 


特 DisplayObjectContainer ク ラス の 子 オ ブ ジ ェクト の 追加 / 削除 に 関す る メソ ッ ド 詳細 


PART 


どど 〆 


adQdChi1d 
(ch1i1d:DisplayOb] ec ) 
:D1Sp1ayOb] ec 上 


addCh11dAt 
(ch1i1d:DisplayOb] ac , 
1nQex : 1n ) 
:D1SplayOb] ec 


etCh11dTndex 
(ch11d:Disp1ayOb] ac ) 
も 


removeCh11d 
(Ch11d:D1sp1ayOb] ec 七 ) 
:D1sSplayOb] ec 


reGmOVeCh1 1 QA 


(1ndex : 1nt ) : DisplayOb] ec 





child を DisplayObjectContainer オ ブ ジ ェクト の 子 と し て 追加 
し ます 。 追加 さ れ た 表示 オブ ジェ クト は 既存 の 子 オ ブ ジ ェ ク 
ト の 上 に 配置 され 、 前 面 に 表示 され ます 。child が 他 の Display 
ObjectContainer オ ブ ジ ェクト の 子 で あっ た 場合 、 そ の 子 オ 
ブ ジ ェクト は 削除 され ます 。 


child を DisplayObjectContainer オ ブ ジ ェクト の 子 と し て 追加 
し ます 。 index に より 、 位 置 を 指定 し て 追加 で きま す 。 位置 は 
0 が 最 育 面 で 、1.2.… の 順に 前 面 に 追加 され ます 。 す で に 使用 
され て いる 番号 を 指定 し た 場合 、 そ の 番号 以上 の 子 オ ブ ジ ェ 
クト の イン デック ス は 繰り 上 げ ら れ ま す 。child が 他 の Display 


ObjectContainer オ ブ ジ ェクト の 子 で あっ た 場合 、 そ の 子 オ 
ブ ジ ェクト は 削除 され ます 。 


child で 指定 し た 子 オ プ ジ ェ クト の イン デック ス 位 置 を 取得 し 
ます 。 


child で 指定 し た 表示 オブ ジェ クト を 表示 リス ト か ら 削 除 し ま 
す 。 削除 され た 表示 オブ ジェ クト の parent プ ロ パ ティ が nul 
に 設定 され ます 。 


index で 指定 し た イン デック ス を 持つ 表示 オブ ジェ クト を 表示 
リス ト か ら 削 除 し ます 。 削除 され た 表示 オブ ジェ クト の 
parent プ ロ パ ティ が null に 設定 され ます 。 





マウ ス ボ タ ン を 9 回 クリ ッ ク し て 
イン スタ ンス を 9 個 作成 し た と ころ 





7-5-4 
ライ ブラ リシン ボル の イン スタ ンス を ステ ー ジ に 配置 する 


= ある = 韻 コ 首 呈 mp】 ヨ 蘭 ----- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


ライ ブラ リシン ボル の イン スタ ンス を ステ ー ジ に 配置 / 削 除 す る MovieCiipSampleD.fla 
// ス テー ジ 上 で マウ ス を クリ ッ ク し た と き に ライ ブラ リシン ボル を イン スタ ンス 化す る 関数 を 呼び ます 
thisg . Stage . addEventL1stener( MouseEvent .CLTCK, attachMov1e  ): 
/ / ラ イブ ラリ シン ボル を イン スタ ンス 化す る 関数 
Function attachMovie ( event :MouseEven ) :void { 
/ / ctr1 キ ー が 押さ れ て いた ら 、 最 後 の イ ン デ ックス を 持つ 子 を 削除 
1f (event .ctr1Key) { 
1f ( thig.numChi1dren > 0 ) 
this . removeCh11qdAt( this .numChi1dren - 1 ): ① 


retuTT : 


/ /a1t キ ー が 押さ れ て いた ら 、 先 頭 の イン デック ス を 持つ 子 を 削除 


if (event .a1tKey) 1 
if ( thisg.numChi1dren > 0O ) 
this .removeChi1qdAt( 0 ): ② 


6G ヒ U 了 IT 


) 

// こ とこ が か ら ラ イブ ラリ シン ボル を イン スタ ンス 化し て 配置 する 手順 

Yar ob] = this .addCh11d( new gymbpo11() ): 

ob] .x=event . staqdeX : ③ 


Ob] .Y=eVent . staqeY : 


この サン ブル で は 、ActionScript 用 に 書き 出し 指定 され た シン ボル (symbol1) を ステ ー ジ 
上 に 配置 し ます 。 配置 は マウ ス の クリ ッ ク で 行い 、 マ ウス ポイ ンタ の 場所 に イン スタ ンス を 移 
動 し ます 。 い で ライ ブラ リシン ボル を イン スタ ンス 化し て 配置 し て いま す 。Ctrl キ ー を 押し な 
が ら ク リッ ク し た 場合 、 い ちば ん 大 きい イン デック ス 値 を 持つ 子 を 削除 し ます 。 こ れ は ① で 
行っ て いま す 。⑧ で は 、alt キ ー を 押し な が ら ク リッ ク し た 場合 、 先 頭 (0) の イン デック ス を 持 
つ 子 を 削除 し ます 。 


ニア < や 回 コ 本 男 有 】 コ 靖 証 - - - - - - - - - - - -------ー-ーーー-ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ニ ーーーー-- 
symbol1 シン ボル の フレ ー ム アク ショ ン 

//showChi1qTndex 関 数 を チェ ッ ク す る た め の イ ベン トバ ハン ドラ 登録 

this .addEventL1gtener ( Event .ENTER FRAME, showChi1dTndex ): 

/ /Chi1dTndex を チェ ッ ク す る た め の 関 数 


funotion showChi1qdTndex ( event :Event ) :void { 


四 " 
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7-5 





シン ボル の タイ ムラ イン アク ショ ン と し て 、 自 分 の 子 Index 番 号 を 表示 する 処理 を 行っ て い 
ます 。Index 値 は 変化 する た め 、enterFrame の イベ ント で 逐次 判定 を 行う よう に し て いま す 。 
子 が 削除 され る と parent プ ロバ パテ ィ が null に な る た め 、 そ の 場合 イベ ント の 処理 を 終了 する よ 
うに し て いま す 。 








Ctrl キー を 押し な が ら マ ウス を クリ ッ ク 
し て 9 番目 の 子 が 削除 され た と ころ 


alt キ ー を 押し て 先頭 の 子 を 削除 し た と こ 
ろ 。 イ ン デ ックス 値 が 繰り 下がっ て いる 


7 - 6 外部 SWF の ロー ド 
Loader クラ ス を 使う 





ActionScript3.0 で は 、 外 部 SWF フ ァイル を 現在 の ムー ビー に 読み 込む 場合 Loader ク ラス を 
使用 し ます 。Loader ク ラス の load() メ ソ ッ ド で ロー ド を 開始 し 、 中 止 する 場合 は cancel() メ 
ソ ッ ド 、 ロ ー ド 後に 削除 する 場合 は unload0 メ ソ ッ ド を 使用 し ます 。Loader ク ラス は JPG、 
PNG、GIF な どの イメ ー ジ ファ イル の ロー ド に も 使用 され ます 。 こ の 革 で は SWF フ ァイル の ロロ 
ー ド を 中 心 に 解説 し ます 。Loader ク ラス に よる 外部 ファ イル ロー ド の 基 本 手順 は 次 の よう に な 
り ま す 。FlashPlayer の セキ ュ リ ティ 制限 に より 、SWF の 発行 元 ド メイ ン と ロー ド す る ファ イ 
ル の ドメイン は 同一 で ある 必要 が あり ます 。 


外 Loader ク ラス に よる 外部 ファ イル ロー ド の 基本 手順 


ロー ド す る ファ イル を 示す 指定 する た め の flash.net.URLRequest ク ラス の イン スタ ンス を 生成 
し ます 。 そ の と き 、 コ ンス トラ クタ に ロー ド す る ファ イル 名 を 指定 し ます 。 パ ス は SWF を 基準 
と する 相対 パス 、http:// で 始ま る URL の どちら も 指定 で きま す 。 


Loader オ ブ ジ ェクト で load() メ ソ ッ ド を 実行 し ます 。 そ の と き 、 パ ラメ ー タ に 1. で 作成 し た 
URLRequest オ ブ ジ ェクト を 指定 し ます 。 


ロー ド し た コン テン ツ を 配置 する DisplayObjectContainer オ ブ ジ ェクト で addChild() メ ソ ッ ド 
を 実行 し ます 。 そ の と き 、 パ ラメ ー タ に 2. で 作成 し た Loader イ ンス タン ス を 指定 し ます 。 ロ 
ー ド され た ファ イル は Loader オ ブ ジ ェクト の 子 と し て 追加 され ます 。 


読み 込ん だ ファ イル に アク | content load() メ ソ ッ ド で ロー ド さ れ た ファ イル の ル 
セス する :D1isplayOb] ec ー ト 表示 オブ ジェ クト へ の 参照 を 得る こと が 
で きま す 。 


ファ イル の 読み 込み 状況 と | contentLoaderTnfo | 読み 込み の 状況 と 読み 込ん だ ファ イル の 規格 

ファ イル に 関す る 大 き さ な | :LhoaderTnfo サイ ズ 、ActionScript バ ー ジ ョ ン な どの 情報 

どの 情報 を 得る を 持つ Loaderlnfo イ ンス タン ス に アク セス で 
きま す 。 





と 5 


PART 
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が ー@ 
外部 SVWF の ロー ド 


符 Loader ク ラス の 主 な メソ ッ ド 概要 


Loader オ ブ プ ジ ェ クト コン スト ラク タ は 引数 を と り ま せん 。 
を 作成 する 読み 込む ファ イル 名 は load() メ ソ ッ ド 
で 指定 し ます 。 


SWF、 イ メー ジフ ァイル の 読み 込 
み を 開始 し ます 。 













| oOad 
redueg : URLReque8g , 

Contex : LOaderContext = nu]11 
) :VO1d 






ファ イル 名 を 指定 し て 
読み 込み を 開始 する 













load0 メ ソ ッ ド で 開始 し た 読み 込み 
を 中 止 し ます 。 


load()) メ ソ ッ ド で 読み 込ん だ オブ 
ジェ クト を 削除 し ます 。 
読み 込ん だ オブ ジェ クト の 実行 を 中 


止 し て オブ ジェ クト の 解放 を 試み ま 
す 。 








読み 込み 処理 を キャ ン 
セル する 


読み 込ま れ た オプ ジェ 
クト を 削除 する 


読み 込ま れ た SWF の | un1oadandStop ( 
実行 を 中 止 し て 削除 す | gc:Boo1ean = true 
る ) :VO1d 


























ニア < ん 1 ニ 』 半 コ 


ーーーー ニ ーー ーーー ーーー デーーーーーーーーーーーーー 一 






! 計 ァ 4 Loeder 2rmp 2 CN SN さい (に か た: Oc 2 が 
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ファ イル FE) 表示 Cy) 恒 特 (CO デバ ッ グ (D 








7-6- 1 
Loader ク ラス を 使う 


サン プル を 開始 する と 表示 され る 「 ロ ー ド 開始 」 ボタ ン を 押し て 、SWF の ロー ド を 開始 し ます 。 


= た 1 上 コ 者 gmp】 コ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


Loader クラ ス で SWF ファ イル を ロー ド す る 大 本 手順 LoaderSampleA.jla 


1mport Flash .net .URLReque8 七 : 
1mport flagsh .display . hoader : 


Ya Url :URLReque8 七 : 


Ya 1dr : TOade : 


// ロ ー ド 開始 ボタン の イベ ント ハン ドラ 登録 
this . startLoad1ng btn .addEventListener (MouseEvent .CLTCK, startLoadind 
) : 





/ / SWF を ロー ド す る 関数 
Function gtartLioadinq ( event :MouseEven ) : vo1d { 
// 1. URLRequest 上 オブ ジェ クト の 生成 ① 
ur] = new URLRequest( "sampleSWF0O1.8wF" ): 
// 2. Loader オ ブ ジ ェクト の 生成 
1dr = new Loader () : 
// 3. 1oad() メソ ッ ド の 実行 
1dr.1oad( ur ): 
が 本 3 義生 
this .addChi1d( 1dr ): 
/ / ボ タン を 非 表示 に (再読 み 込み 防止 ) 


this . startLioad1nqg _Dtn.Y181b1e = false: 


「Loader ク ラス に よる 外部 ファ イル ロー ド の 基本 手順 ] で 解説 し た 手順 の と お り に Loader オ 
ブ ジ ェクト を 作成 し て ファ イル を ロー ド し ます 。① の 範囲 が その 手順 で す 。②⑧ で 指定 し て いる 
"sampleSWF01.swf" フ ァイル は この サン プル の SWF フ ァイル と 同じ 場所 に ある こと を 想定 し 
て いま す 。③ で addChild() メ ソ ッ ド を 実行 し て いま す が 、 こ の メソ ッ ド を 実行 し な いと 、 ロ ー 
ド の み し て 画面 に は 表示 され ませ ん 。 
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外部 SWF ファ イル を ロー ド す る 
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Loader ク ラス を 使用 し て 外部 SWF フ ァイル を ロー ド す る と き に 重要 と な る の が ロー ド の 状況 
に 基づく イベ ント に な り ま す 。 load() メ ソ ッ ド の 実行 に 関連 する イベ ント を 把握 し て お く 必 要 が 
あり ます 。 こ こ で は 、 前 節 で 解説 し た 基本 手順 に イベ ント に よる 状況 の 取得 を 追加 する 方 法 を 
解説 し ます 。Loader ク ラス が 送出 する 主 な イベ ント は 下 表 の と お り で す が 、 読 み 込み の 状況 を 
管理 する の が LoarderInfo オ ブ ジ ェクト で ある た め 、 イ ベン ト も この オブ ジェ クト が 送出 し ます 。 
その た め 、 イ ベン ト を リス ン す る オブ ジェ クト は Loader で は な く 、Loader オ ブ ジ ェクト の 
contentLoaderInfo プ ロバ ティ で 参照 で きる Loaderlnfo オ ブ ジ ェクト に な り ま す 。 イ ベン ト 
処理 は 、 イ メー ジフ ァイル を ロー ド す る 場合 も 同様 に 行う こと が で きま す 。 


馬 Loader ク ラス の load() メソ ッ ド の 実行 で 送出 され る イベ ント 詳細 


complete:Event ファ イル の 読み 込み が 完了 し た と き に 、contentLoaderInfo オ 
プ ジ ェ クト に よっ て 送出 され ます 。 init イ ベン ト の 後に 送出 され 
ます 。 


httpStatus:HTTPStatusEvent ネッ トワ ー ク 要求 が HTTP 上 で 行わ れ 、Flash Player が HTTP 状 
況 コー ド を 検出 で きる 場合 に 、contentLoaderlnfo オ ブ ジ ェ ク 
ト に よっ て 送出 され ます 。 


init:Event 読み 込ま れ た SWF フ ァイル の プロ パテ ィ お よび メソ ッ ド に アク 
セス で きる 場合 に 送出 され ます 。 int イ ベン ト は complete イ ベ 
ント の 前 に 送出 され ます 。 initt イ ベン ト の 送出 時 は 次 の 処理 が 完 
了 し て いま す 。 
読み 込ま れ た オブ ジェ クト に 関係 し た すべ て の プロ パテ ィ と メ 
ソ ッ ド 、 お よび LoaderInfo オ ブ ジ ェクト に 関係 し た すべ て の プ 
ロ パ ティ と メソ ッ ド に アク セス 可能 


すべ て の 子 オ ブ ジ ェクト の コン スト ラク タ が 完了 済み 


ロー ド さ れ た SWF の メイ ンタ イム ライ ン の 最初 の フレ ー ム に 含 
まれ る すべ て の ActionScript コ ー ド が 実行 済み 


ioError:IOErrorEvent 入出 力 エ ラー が 発生 し て 読み 込み 処理 が 失敗 し た と き に 送出 さ 
れ ま すず 。 


読み 込み 処理 が 開始 し た と き に 送出 され ます 。 
progress:ProgressEvent 読み 込み 処理 を 実行 中 に デー タ を 受信 し た と き に 、 送 出さ れ ま す 。 


securityError:SecurityErrorEvent | ロー カル ファ イル シス テム の サン ド ボ ッ クス 内 の SWF フ ァイル 
が ネッ トワ ー ク 接続 し た ロー カル の サン ド ボ ッ クス 内 の コン テ 
ン ツ を 読み 込 も うと し た か 、 また は その 逆 の 場合 に 送出 され ます 。 


unload:Event 読み 込ま れ た オブ ジェ クト が 削除 され る と き に 送出 され ます 。 


7-6-2 
外部 SWF ファ イル を ロー ド す る 


軌 Loader ク ラス の 読み 込み 情報 に 関す る メソ ッ ド 


1oad SWF フ ァイル 、 イ メー ジフ ァイル を ロー ド し ます 。 成功 し 
(request : URLReque8t , た 場合 、 こ の Loader オ ブ ジ ェクト の 子 と し て 格納 し ます 。 
context : LoaderContext = nu11) | Loader オ ブ ジ ェクト は 1] つの 子 し か 格納 で き な い た め 、 同 
: VO1d じ オ ブ ジ ェクト で 別 の ファ イル を ロー ド す る と 入れ 替わり 

が 発生 し ます 。 読み込め る ファ イル は 次 の と お り で す 。 

SWF 

JPEG 

プロ グレ ッ シ ブ JPEG 

非 ア ニメーション GIF 

PNG 


現在 進行 中 の load() メ ソ ッ ド の 処理 を キャ ン セ ル し ます 。 


un]oad ( ) : void load() メ ソ ッ ド を 使用 し て 読み 込ま れ た オブ ジェ クト を 、 
Loader イ ンス タン ス の 子 か ら 削 除 し ます 。 読み込ま れ た 
オブ ジェ クト 自体 は 可能 な 場合 、 削 除 さ れ ま す 。 


un1oadAndStop 子 SWF フ ァイル の アン ロー ド を 試み 、 ロ ー ド され た SWVF 
(dC : BOOolean = FUG ) ファ イル の コマ ンド の 実行 を 中 止 し ます 。 子 SWF で は 次 
: YO1d の 処理 が 行わ れ ま す 。 
サウ ンド は 停止 され ます 。 
Stage の イベ ント リス ナー が 削除 され ます 。 
enterFrame、frameConstructed、exitFrame、 
activate、deactivate の 各 イ ベン トリ スナ ー が 削除 され ます 。 
タイ マー は 停止 され ます 。 
Camera イ ンス タン ス お よび Microphone イ ンス タン ス が 
解放 され ます 。 
ムー ビー クリ ッ プ は 停止 され ます 。 








ファ イル (F) 表示 (Y) 叫 伯 (CO デバ ッ グ (D) 


へ AMP し LE REPEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


ファ イル 名 (URL) イベ ソト が 発生 し まし た :open 
saimpleSWFD1 swvf イベ ント が お 発生 し まし た -: ing 
イベ ント が 発生 し まし た : httpStatus 
イベ ント が 発生 し まし た - complete 
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7-6 
外部 SWF の ロー ド 


外部 SWF フ ァイル の ロー ド が 正常 に 完了 し た と き に は この よう な 画面 と な り ま す 。 


= が 2 画 コ 首 中 mp】 コ 蘭 |--- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


外部 SWF を ロー ド し て イベ ント 処理 を 行う LoaderSampleB.fla 


1mport fl]agh .net .URLRequeg: 
1mport flagh.disp1ay .Loader : 


Ya uu エ 」 :URLRequeg : 


Var dr :Loader : 


// ロ ー ド 開始 ボタ ン の イベ ント ハン ドラ 登録 
this . St 上 artTioad1ng btn .addEventListener (MouseEvernt .CLiTCK, 


StartLoadind ): 


/ / SWF を ロー ド す る 関数 
Function startLoadinq( event :MouseEvent ) :vo1d { 

// 1. URLRequest オ ブ ジ ェクト の 生成 

ur =new URLRequest( filename txt.text )。: 

// 2. Loader オ ブ ジ ェクト の 生成 

1dr = new Loader () : 

/ /Loader オ ブ ジ ェクト の イベ ント ハン ドラ を 追加 

1dr .ConentLoaderTnfo . addEventL1i stener ( 
EVent .COMPLETE, showEvent ): 

1dr . ContentLoaderTnfo . addEventListener ( 
HTTPStatusEvent .HTTP STATUS, showEvent ): 

1dr . ContentLoaderTnfFo . addEventLii stener ( 
Event . INTT, showEvent ): 

1dr . ContentTLoaderTnfo . addEventTLi1 gtener ( 
Even .OPEN, showEvent ): 

1dr .ConEentTLoaderTnfo . addEventTLii gt 上 ener ( 
TOE エ YOrEVent . TO_ERROR, showEVvent ): 

1dr .ContentTLoaderTnfEo . addEventLi1 st 上 ener ( SeCu エ 1tyE エ OrEVent . 

SECURTTY ERROR, 8howEvent ): 

// 3. 1oad ( ) メソ ッ ド の 実行 

よ GY 、 上 の ad ( UY] ): 

// 4. addChi1d ( ) メソ ッ ド の 実行 

this .addChi1d( 1dr ): 

/ / ボ タン を 非 表 示 に (再読 み 込み 防止 ) 


/ー ら 6-〆 
外部 SWF ファ イル を ロー ド す る 


this . St 上 artLoad1nqd DEtn .Y181D1e=fFa] 8e : 


// イ ベン ト の 発生 を 出力 する 関数 
Funotion ghowEvent (event : Event ) :Yo1d 1 


output xt .appendText( "イベ ント が 発生 し まし た :" + event .tyDpe + " ぎ n" ): 


Loader オ ブ ジ ェクト に よる 基本 手順 は 同じ で す が 、load() メ ソ ッ ド を 実行 する 前 に 、① で 
行っ て いる よう に 、 イ ベン トリ スナ ー を 登録 し て お きま す 。 こ の サン プル で は 、 ロ ー ド の 開始 、 
完了 、 エ ラー な どの 基本 イベ ント を 取得 し て テキ スト エリ ア に 出力 し て いま す 。SWF だ け で な 
く 、 イ メー ジフ ァイル の ロー ド も 同様 に 行う こと が で きま す 。 フ ァイル 名 間違い な ど で 指 定 し 
た ファ イル が 存在 し な いと き 、ioError が 発生 し ます 。 こ 


AN 


還 イメ ー ジ ファ イル (PNG) を ロー ド し た 場合 





| や LoaderSampleB.swf っ P- 了 < 琉 
ファ イル (F) 表示 (y) 一 御 (CO デバ ッ グ (D) 








| | ファ イル 名 (LRL) 


イベ ント が 発生 し まし た :open 

| | DarkNightiImage2 png イベ ント が 発生 し まし た :ini 

置 イベ ント が 発生 し まし た : httpStatus 
| イベ ント が 発生 し まし た : complete 





一 ロー ド エ ラ ー( フ ァイル が 存在 し な い 場 合 ) 


イベ ント お 発生 し まし た : httpStatus 
イベ ント が 発生 し まし た :joError 











た と えば ロー カル ファ イル 以外 の ファ イル 名 (http://xxx.com/sampleSWF01.swf な ど ) を 
指定 し た 場合 、SecurityError: Error #2028 が 発生 し ます 。 
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7-6 
外部 SWF の ロー ド 


Adobe Fesh Player セキ ュ リ ティ 
Adobe Flash Player は 洪 在 的 に 危険 な 折 作 を 倍 止 し まし た 。 


お 客 様 の コノ ビ ピュータ また は ネッ トワ ー ク で 7? 大 の ロー カル アプ リケーション : 
ます V:\documentsWbw\SoftbankWasWfiaWforUsersoaderSampleB.swf 
は 、 イン ター ネッ ト 接 続 が 有効 に な っ て いる 7 人 X の 場所 と 適 信 し よう と し て いま す : 
www.Websysd.Com 
PART この アブ リケーション が イン ター ネッ ト 通 信 で きる よう に する に け 、 


「 六 定 」 を が リッ ク し て くだ さい 。 
設定 の 変更 後 、 アプ リケーション を 再起 勤 する 必要 が あり ます 。 





この よう な 場合 、 ア プリ ケー ショ ン の SWF フ ァイル と ロー ド す る ファ イル を Web サ ー バ 
(http://xxx.com) に 配置 し て 、 読 み 込 むせ ファ イル も http://xxx.com/sampleSWF01.swf の よ 
うに 指定 する と 、 セ キュ リティ エラ ー は 表示 され ず 、 フ ァイル が 正常 に ロー ド さ れ ま す 。 


遼 正常 に ロー ド さ れ た 例 


@Loa jerS mpleB - Windows Inte の VM SD こさ 
] | 門 coogle 






ファ イル (PF) 編集 (E) 表示 (Y) お 気に入り (A) ツー ル ) ヘル プ け ) 
疹 LoaderSampleB 


tgGLSr O 和 gm Sg7 


イベ ント が 発生 し まし た : open 

イベ ント が 発生 し まし た :init 
イベ ント が 発生 し まし た : httpStatus 
イベ ント が 発生 し まし た : complete 





ペー ジ が 表示 され まし た 介 イン ター ネッ ト | 保護 モー ド : 有効 


3Z 


SWF ファ イル の 読み 込み 情報 を 
調べ る 





ロー ド す る SWF フ ァイル の 読み 込み 状況 を ユー ザ に 表示 する 必要 が ある と き 、MovieClip ク 
ラス と 、LoaderInfo ク ラス の プロ バ パティ と イベ ント が 使用 で きま す 。MovieClip ク ラス の 
framesLoaded プ ロバ ティ は 読み 込み 済み の フレ ー ム 数 を 表し ます 。 こ の プロ パテ ィ と 全 フ レ 
ー ム 数 を 表す totalFrames プ ロバ ティ を 計算 する と 全体 の 何 % の フレ ー ム が 読み 込み 済み か を 
調べ る こと が で きま す 。 読み 込ん だ サイ ズ の 情報 は 、DisplayObject ク ラス の loaderInfo プ ロ 
バテ ィ で 得る こと が で きま す 。 こ の プロ パテ ィ は 読み 込み サイ ズ に 関す る デー タ を 保持 する 
LoaderInfo ク ラス の イン スタ ンス へ の アク セス を 提供 し ます 。LoaderInfo イ ンス タン ス が 受 
ける progress イ ベン ト で 読み 込み 状況 、complete イ ベン ト で 読み 込み の 完了 を 知る こと が で 
きま す 。 


符 DisplayObject ク ラス の 読み 込み 情報 に 関す る プロ パテ ィ 詳 細 
amesLoaded | SWF フ ァイル の ロー ド 済 み フ レー ム 数 を 表し ます 


SWF フ ァイル の トー タル フレ ー ム 数 を 表し ます 


SWF フ ァイル の 読み 込み 済み サイ ズ ( バ イト 数 )、 全 体 サ イズ (バイ ト 数 ) を 提供 す 
る LoaderInfo オ ブ プ ジ ェ クト へ の 参照 を 提供 し ます 。 こ の オブ ジェ クト は 読み 込ま 
れる SWF、 イ メー ジフ ァイル に 関す る 読み 込み 状況 や サイ ズ を 提供 し ます 。 











| 〇 aQGYITnf 


: OoaderTnFfFoO 






移 Loaderlnfo クラ ス の 読み 込み 情報 に 関す る プロ パテ ィ 詳 細 - 
プロ パテ ィ プロ パテ ィ の 詳細 





SWF フ ァイル の 読み 込み 済み バイ ト 数 を 表し ます 。 








SWF フ ァイル の トー タル バイ ト 数 を 表し ます 。 





物 Loaderlnfo クラ ス の 読み 込み 情報 に 関す る イベ ント 詳細 


イベ ント 定数 : 下段 は 定数 イベ ント の 詳細 


DrOdreSS | 読み 込み 処理 を 実行 中 に デー タ を 受信 し た と き に 、 送 出さ れ ま す 。 
ProgressEvent.PROGRESS 
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プー-6 
外部 SWF の ロー ド 


馬 Loaderlnfo クラ ス の 読み 込み 情報 に 関す る イベ ント 詳細 (続き ) 
イベ ント 定数 : 下 段 は 定数 イベ ント の 詳細 
謗 み 込ま れ た SWF フ ァイル の プロ パテ ィ お よび メソ ッ ド に アク セス で 


きる 場合 に 送出 され ます 。 int イ ベン ト は complete イベ ント の 前 に 送 
Event.INIT 


出さ れ ま す 。 init イ ベン ト の 送出 時 は 次 の 処理 が 完了 し て いま す 。 
Event COMPLETE 
IOErrorEvent.IO_ERROR 


ロー ド 中 を 表す 
プロ グレ スバ ー 



















PART 


・ 読 み 込 まれ た オブ ジェ クト に 関係 し た すべ て の プロ パテ ィ と メソ ッ 
ド 、 お よび Loaderlnfo オ ブ ジ ェクト に 関係 し た すべ て の プロ パテ ィ 
と メソ ッ ド に アク セス 可能 

・ す べ て の 子 オ ブ ジ ェクト の コン スト ラク タ が 完了 済み 

・ ロ ー ド され た SWF の メイ ンタ イム ライ ン の 最初 の フレ ー ム に 含ま れ 

る すべ て の ActionScript コ ー ド が 実行 済み 






ファ イル の 読み 込み が 完了 し た と き に 、contentLoaderInfo オ ブ ジ ェ 
クト に よっ て 送出 され ます 。 init イ ベン ト の 後に 送出 され ます 。 


入出 カエ ラー に より 読み 込み が 失敗 し た と き に 送出 され ます 。 





8 人 
覆 ROD ASS2CSSSGR ror DDSASOS ーー NSMTNKSS、 YSCNOESRNOSE つ ここ ここ っ 
放 本 が 9 |e」 「tp:/nowwwebeymlcmmmg/z- te ん oedmt <| ヶ | X 上 間 coo9e uh 
ファ イル (FE) 畑作 E) 表示 VO お 気に入り (AD) ツー ル D ヘル プ G⑪ 


喜 秦 Lom の CFSKCT3E 





ロー ド が 完了 し て 
再生 し た SWF 


ファ イル 名 (URL) 


読込 が 完了 し まし た 
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ニー アー 1 ニ 肖 コ 科 mf mip】 コ 


SWF ファ イル の 読み 込み 状況 を 調べ る 


7-6-3 


SWF ファ イル の 読み 込み 情報 を 調べ る 


1mport fFlash.net .URLReques 七 : 


1mport fFlash.display . Loader: 


1mpor 上 FfF] .Contro1]s . ProdressBarMode : 


Var ul :URLRequeg : 


Var 1dr :Loader: 
// ロ ー ド 開始 ポ ボタン の イベ ント ハン ドラ 登録 
this . startLoading btn.addEventListener (MouseEvent .CLiTCK , 


8tartLoad1nd ): 
/ / SWEF を ロー ド す る 関数 


Function startLoading( event :MouseEvent ) :vo1d { 


) 


// 1. URLRequest オ ブ ジ ェクト の 生成 

ur =new URLReques 上 (Ei]1emame 上 xt .ex) : 

// 2. Loader オ ブ ジ ェクト の 生成 

1dr = new Loader () : 

/ /Loader オ ブ ジ ェクト の イベ ント ハン ドラ を 追加 

1Qr .ContentTLoaderTnfo . addEventListener( ProqressEvent . 
PROGRESS , ghowEvent ) 

1Qdr .ContentLoaderTnfo . addEventListener ( Event . COMPT」ETE , 


8hOwEVert ): 


1dr .ContentLoaderTnfo.addEventLi stener ( TOErrorEvent . TO ERROR, 


8howEVent ): 
// 3. 1oad ( ) メソ ッ ド の 実行 
1Qr.1oad( ur] ): 


/ / プ ログ レス バー の 設定 


Funotion setProgressbar ( ) :vo1d { 


) 


thigs .Dbytes proqres8 .mode = ProqressBarMode . MANUAT : 
thisg .byte8 proqdreSs8 .m1n1mum = 0: 


this .bytes progdres8 . SetProgress( 0, 100 ): 


// イ ベン ト の 発生 を 出力 する 関数 


Function showEvent (event : Event ) :vo1d { 


switch ( event .type ) { 
CaSse TOErrOrEVen . TO_ERROR : 
percent tx .Eex ヒ = "読込 時 に エラ ー が 発生 し まし た ": 
Dreak : 


Ca8eG PrOdFre88EVen . PROGRESS 


LoaderSampiet.fla 
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7-6 
外部 SWF の ロー ド 


thisg .byte8 prOdre88 . SetProgregss ( 1qdr.cContentLoaderTnfo . 
bytesLoaded, 1qr.contentLoaderTnfFo.bytegTota1 ): 
percernt tx .tex = nt (Dyte8 DrOdre88 .DeGrCentComp1ete) + 『 る 
読込 済 " : 

breaK : 
Ca8e Event .COMPLETE : 

// 4. addChi1d () メソ ッ ド の 実行 

this .addChi1d( 1dr ): 

/ / 読み 込ん だ コン テン ツ を ステ ー ジ の 中 央 に 配置 


1dr.x = ( stage .8tageW1dth - 1qdr.contentLoaderTnfo.w1Qdth ) 
/ 2: ⑩ 
1dr.y = ( ( stage . stageHe1ght - 100 ) - 1qdr.contentLoader 


Tnfo.height ) / 2 

/ / ボ タン を 非 表 示 に (再読 み 込み 防止 ) 

this . startLoading btn . 立 181D1e = fa186: 
percent txt.texE = "読込 が 完了 し まし た 『": 


D わ と て @aK : 


) 
/ / プ ログ レス バー の 設定 


Set Progres8bar ( ) : 


この サン プル で は 、 進 行状 況 と ロー ド の 完了 を イベ ント で 取得 し ます 。 そ の た め 、load0 メ 
ソ ッ ド の 実行 後 、addChild() メ ソ ッ ド を 実行 する 部 分 は 完了 の イベ ント ハン ドラ 内 で 行う よう 
に し て いま す 。 こ こ で 使用 する イベ ント は progress (ロー ド 進 行 中 ) と complete (ロー ド の 完 
了 ) で す 。progress イ ベン ト ハ ンド ラ 内 で 読み 込み 済み の サイ ズ を 取得 し て 全体 の ロー ド 状 況 
と プロ グレ スバ ー に 表示 し ます 。 こ れ は ① の イベ ント ハン ドラ 内 で 行っ て いま す 。 こ の ハン ド 
ラ は イベ ント に 共通 で 使用 する た め 、event.type プ ロ パ ティ に より 、 内 部 で 処理 を 条件 分 けし 
て いま す 。 

progress イ ベン ト の と き は プロ グレ スバ ー の setProgress() メ ソ ッ ド に Loader オ ブ ジ ェクト 
の contentLoaderInfor プ ロ パ ティ で 参照 で きる Loaderlnfo オ ブ ジ ェクト の bytesLoaded ブ プ 
ロ パ ティ で ロー ド 済 み バ イト 数 を 取得 し て いま す 。 

complete イ ベン ト は ロー ド が 完了 し て いる の で 、addChild() メ ソ ッ ド で ステ ー ジ に 配置 し 、 
ロー ド し た SWF の サイ ズ を 取得 し て 位置 を 中 央 に 配置 し て いま す 。 


7 - 7 モー ショ ント ゥ イー ン 
Motion クラ ス を 使う 





ActionScript で モー ショ ント ウゥ イー ン を 作成 する と き に は 、ff.motion パ ッ ケ ー ジ の クラ ス 
を 使用 し ます 。 メ イン と な る の は Motion ク ラス と AnimatorFactory ク ラス に な り ま す 。 
MotionBase ク ラス は Motion ク ラス の 親 ク ラス で 、 基 本 機能 を 提供 し ます 。 トゥ イー ン の 内 
容 に より 、flash.geom バ パッケージ や flash.fijlters パ ッ ケ ー ジ の クラ ス も 使用 し ます 。Action 
Script に よる モー ショ ント ゥ イー ン の 作成 手順 は 次 の よう に な り ま す 。 


乱 ActionScript に よる モー ショ ント ゥ イー ン の 作成 手順 
手順 使用 する プロ パテ ィ / メ ソ ッ ド 


アニ メー ショ ン の 基本 と な る プロ パテ ィ を | addPropertyArray() メ ソ ッ ド 


AnimatorFactory オ ブ ジ ェクト を 作成 する | コン スト ラク タ に Motion オ ブ ジェ クト を 渡し ます 。 


アニ メー ショ ン を 適用 する イン スタ ンス を | agdTarget() メ ソ ッ ド 





筆 Motion ク ラス の 主 な プロ バテ ィ 概 要 (MotionBase クラ ス の プロ パテ ィ を 含む ) 


モー ショ ン の 継続 時 間 du フレ ー ム 数 で Motion イ ンス タン ス の 継続 時 間 を 制 

仙 し ます 。 
モー ショ ン が 3D プ ロ パ ティ を 含む か どう か を 指定 
し ます 。 













ob , 
ご っ] 





3D プ ロ パ ティ を 持つ モー ショ ン 
を 作成 













: Boolean 








乱 Motion クラ ス の 主 な メソ ッ ド 概要 (MotionBase クラ ス の メソ ッ ド を 信 む ) 
モー ショ ン に フィ ルター | initFi1terg フィ ルター を 初期 化し ます 。 


を 追加 
キー フレ ー ム を 基準 と し た フィ ルター の 


設定 を 行い ます 。 
キー フレ ー ム を 追加 iddKeyframe 


Motion イ ンス タン ス に キー フレ ー ム を 
モー ショ ン に プロ パテ ィ 


追加 し ます 。 
の 変更 を 追加 




























キー フレ ー ム を 基準 と し た プロ パテ ィ の 
設定 を 行い ます 。 こ の メソ ッ ド に よる プ 
ロ パ ティ が アニ メー ショ ン の 基準 に な り 
ます 。 






っ 3/ 
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7ー7 
モー ショ ント ウゥ ウイーン 


乱 Motion クラ ス の 主 な メソ ッ ド 概要 (MotionBase クラ ス の メソ ッ ド を 人 訪 む )( 続 き ) 





アク ティ ブ な キー フレ ー | qetCurrentKeyframe 現在 アク ティ ブ な キー フレ ー ム を 取得 で 
ム を 取得 きま す 。 ト ゥ イー ン 可 能 な プロ パテ ィ 名 





を 指定 で きま す 。 


フレ ー ム イン デック ス を 指定 し て トゥ イ 
ー ン プロ パテ ィ 値 を 取得 し ます 。 


フレ ー ム イン デック ス を 指定 し て トゥ イ 
ー ン プロ パテ ィ 値 を 設定 し ます 。 









ある フレ ー ム の トッ ゥ イー | getValue 
ンプ ロ パ ティ 値 を 取得 

ある フレ ー ム の トッ ゥ イー | getV 
ンプ ロ パ ティ 値 を 設定 







コン スト ラク タ で す 。 引 数 に Motion オ ブ ジ ェ ク 
ト を 指定 し て 関連 付け を 行い ます 。 


Motion ト ゥ イー ン を 表示 オブ ジェ クト に 適用 し 
ます 。 






ーー トー15- 展 訴 


デバ ッ ク (D) 


弓 AMPLE C ロ DE EE5555 


Motion クラ ス に よる シン ブル な アニ メー ショ ン MotionTweenSampleAHla 


1mport ] .motion .Amn1matOrFactOry: 
1mport FfF] .mot1on .Mot1onBa86e: 


1mpor F] .mot1on .Mot1oOn : 


//1 . Motion オ ブ ジ ェクト を 作成 


Var myMot1on :Motion = new Motion () : 


リー ザー* 


Motion クラ ス を 使う 
/ / 2 . 時 間 を 設定 
NO も まま OU 人 0 生生 
//3 . アニ メー ショ ン の 基本 と な る プロ パテ ィ を 設定 
VMMO も Or 、 AdGPEODG エ も y 和 ATF み Y "kT。 OH/ 10.。 20。 30。 4 )) ーー ビーーー デ ーー の 9 


//4. AnimatorFactory オ ブ ジ ェクト を 作成 


Var myAf :An1imatorFaCtOory = new An1matorFactory( myMotion ): 


//5. アニ メー ショ ン を 適用 する イン スタ ンス を 設定 
myAf .addTarget ( target01 ): 
myAf . addTarget ( target02 ): 
myAf .addTarget ( target03 ): 


(② 


基本 手順 どおり の サン プル で す 。① で 行っ て いる 時 間 の 設定 は 、 通 常 ① で 行う よう な アニ メ 
ーション プロ パテ ィ 値 の 配列 の 要素 数 と 等 し い 値 に し ます 。 時 間 の 設定 に つい て は 、 
「 モ ーション トゥ イー ン ア ニメーション を 行う 」 を 参照 し て だ さい 。@ で 行っ て いる addProper 
tyArray() メ ソ ッ ド で プロ パテ ィ の 変化 を 指示 し ます 。 こ こ で は 、x プ ロバ ティ の 値 を 0 一 10 一 
20 一 30 一 40 一 0 一 10… と 変化 させ る 指定 を し て いま す 。 (3 で アニ メー ショ ン を 適用 する イン ス 
タン ス を 設定 し て いま す が 、 こ こ で は ステ ー ジ 上 の 3 つの イン スタ ンス に 適用 し て いま す 。 
target01 一 target03 は イン スタ ンス 名 で す 。 結果 と し て 、3 つ の アニ メー ショ ン に 同じ ブ プロバ 
ティ の 変化 を も た ら す アニ メー ショ ン が 適用 され ます 。 
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アニ メー ショ ン を 行う 


Motion ク ラス と AnimatorFactory ク ラス に より 、 ト ゥ イー ン ア ニメーション を 作成 で きま 
す 。 こ こ で は プロ パテ ィ の 変化 に よる 、 プ ロ パ ティ ベー ス の トゥ イー ン を 解説 し ます 。 ア ニ メ 
ーション の 基本 と な る キー フレ ー ム の プロ パテ ィ 変 化 は Motion ク ラス の addPropertyArray() 
メソ ッ ド で 行い ます 。 モ ーション トゥ イー ン の 対象 と な る 主 な プロ パテ ィ に は 、 下 表 の も の が 
あり ます 。 


鐵 モー ショ ント ゥ イー ン ア ニメーション の 対象 と な る プロ バテ ィ 


林 の 座標 空間 で の 、 オ ブ ジ ェクト の 変形 点 の 水平 / 垂 直 / 深 度 (z 軸 ) 位置 










変形 点 か ら 適 用 され る オブ ジェ クト の 水平 / 垂 直方 向 の 拡大 / 縮 小 率 (パー セン 


テー ジ ) 





変形 点 か ら 適用 され る オブ ジェ クト の 水平 / 垂 直方 向 の 傾斜 角度 
x/y 軸 に 対す る オブ ジェ クト の 元 の 方 向 か ら の 回 転 








変形 点 か ら 適 用 され る 、 以 前 の 方 向 に 対す る 相対 的 な 動作 で の オブ ジェ クト の 
回 転 (Z 軸 ) の 値 


オブ ジェ クト の 色 と 下 に ある グラ フィ ッ ク の 混合 を 指定 する BlendMode ク ラ 
ス の 値 


















キー フレ ー ム に 指定 され て いる 場合 は 、 そ の matrix3D プ ロ パ ティ 。3D ト ッ ゥ イ 
ー ン に 使用 され ます 。 使用 され る と 、 そ れ ま で の すべ て の 変形 プロ パテ ィ は 無 
視 さ れ ま す 。 


3③D 親 コン テ ナ を 基準 と する 、 元 の 方 向 か ら の オブ ジェ クト の z 軸 の 回 転 ( 度 )。 
3D ト ゥ イー ン で rotationConcat の 代わ り に 使用 され ます 。 







息 Motion クラ ス の アニ メー ショ ン の た め の プ ロ パ ティ 詳細 


プロ パテ ィ プロ パテ ィ の 詳細 





Motion オ ブ ジ ェクト の 継続 時 間 を 表し ます 。 通常 は この 値 と 等 し い 要 素数 の 
キー フレ ー ム 値 の 配列 を addPropertyArray() メ ソ ッ ド に 渡し て プロ パテ ィ 値 
の 変化 を 定義 し ます 。 配列 の 要素 数 が duration よ り 多 い 場 合 、duration 値 は 
それ に 合わ せ て 調整 され ます 。 配列 の 要素 数 が duration よ り 小 さい 場合 、 配 列 
の 最後 の 要素 の 値 が 最後 の フレ ー ム まで 維持 され ます 。 















筆 Motion クラ ス の アニ メー ショ ン の た め の メ ソ ッ ド 詳細 


addPrODG エ ヒ yA 了 エエ ay Motion オ ブ プ ジ ェ クト に アニ メー ショ ンプ ロ パ ティ を 設定 し ます 。 
( index : in , name : プロ パテ ィ 名 
name : S 上 rind , values : name で 指定 し た プロ パテ ィ の 値 の 変化 を 表す 配列 で す 。 配列 内 


Va1u@G8 : AF エエ ay , の 値 の 順序 に よっ て 、 キ ー フ レー ム へ の それ ぞ れ の 値 の 割り 当て が 決ま り 
StartFrame : 1nt = ます 。 配列 内 の null 以 外 の 値 の それ ぞ れ に つい て 、 キ ー フ レー ム に プロ パ 
-1 , ティ 名 / 値 の ペア を 格納 し ます 。 

endFrame : 1n = startFrame、endFrame で 適用 する 開始 / 終 了 フ レー ム を 設定 で きま す 。 


- 1 ) :VO1d 





和 m AnimatorFactory クラ ス の メソ ッ ド 詳細 


adQdTarqde Motion オ ブ ジ ェクト を 表示 オブ ジェ クト に 適用 し ます 。 こ の 
(target : Disp1ayOb] ec , メソ ッ ド で 指定 され た 表示 オブ ジェ クト に Motion オ ブ ジ ェ ク 
repeatCount:int = 0, ト が 持つ アニ メー ショ ント ゥ イー ン が 実行 され ます 。 
autoP1ay : Boolean = true , target : トゥ イー ン を 適用 する 表示 オブ ジェ クト 
gtartFrame:1nt = -1, repeatCount : アニ メー ショ ン の リピ ー ト 回 数 で す 。 デ フォ 
useCurrentFrame : Boo]ean = ルト の 0 で は 無限 に 繰り 返し ます 。 
Fa]1se autoPlay : true の 場合 、 ア ニメーション を 自動 で 開始 し ます 。 
) :AnimatorBagse startFrame : 親 の タイ ムラ イン を 基準 と する 、 ア ニ メ ー シ ョ 
ン が 開始 する フレ ー ム で す 。 
useCurrentFrame : true の 場合 、 タ ー ゲ ッ ト オ ブ ジ ェクト を 
配置 する アニ メー ショ ン フ レー ム を 決定 する 親 の currentFram 
e プ ロ パ ティ を 使用 し ます 。 


ーーーーーー 半 和 (O ーーーーー ー 








に 1 部 コ 半 mHm ら 】 ヨ - - - --------------------ー-ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


複数 の Motion オブ ジェ クト を 作成 し て 表示 オブ ジェ クト に 割り 当て る 胡 otionTweenSampleB.fla 


1mport fF] .mot1on .An1ma 上 OFFaCO 了 エ Y : 
1mpor 上 FfF] .mot1on .MoOt1onBa8e : 
1mDpor f] .mot1on .Mot1On : 


1mport flash.display .B1endMode : 
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//1 . Motion オ ブ ジ ェクト を 作成 


Var myMot1on1 :Mot1on = new Mot1on ( ) : 


var myMotion2 :Motion = new Mot1on ( ) : 

Ya myMot1on3 :Mot1on = new Mot1on ( ) : 

/ /2 . 時 間 を 設定 

myMotion1 .duration = 10: 

myMotion2 .duration = 10: 

myMot1on3 . durat1on = 10: 

//3 . アニ メー ショ ン の 基本 と な る プロ パテ ィ を 設定 

myMot1on1 . addPropertyArray("x", [0, 20, 40, 60, 80, 100, 120, 140, 
160, 180] ): 

myMot1on1 . addPropertyArray("scale 双 ", [1, 1, 0.8, 0.8, 0.4, 0.4] ): 
myMot ュ on2 . addPropertyArray("x", [0, 0, 0, 9,。 348, 60, 90, 

120, 160, 1801 ): 

myMot1on2 . addPropertyArray ( "rotat1onConcat", [0, 30, 90, 180, 180, 
180。 90, 30, 0] )。 

myMotion3 . addPropertyArray("x", [0, 科 2 9。 0, 0, 0, 0, 
60 。 は ま 信 。 3 きり] け ょ 

myMo1ion3 . aQdPropertyArray ("blendMode", [BlendMode . NORMAT , 

Bl endMode .NORMATL, BlendMode .NORMAL, BlendMode . SCREEN, BlenQdMode . 
SCREEN, Bl]endMode . SCREEN] ): 

//4 . AnimatorFactory オ ブ ジ ェクト を 作成 

Var myAf1 : AnimatorFaotory = new An1matorFactory( myMotion1 ): 


〇 


Var myAf2 :AnimatorFactory = new An1matorFactOry ( myMotion2 ): 

Var myAf3 : An1imatorFaotory = new An1matorFaotory( myMotion3 ): 

//5. アニ メー ショ ン を 適用 する イン スタ ンス を 設定 

myAFE1 .adQdTarget( tarqget01, 1 )』 

myAf2 .addTarget ( target02, 2 ): ② 
myAf 3 .addTarget ( target03, 3 ): 


基本 手順 に ほん の 少し アレ ンジ を 追加 し た サン プル で す 。Motion オ ブ ジ ェクト を 複数 作成 し 
て お き 、 プ ロ パ ティ を セッ ト し て お く こ と で 、 同 じ ア ニメーション を 繰り 返し 使用 する こと も 
で きま す 。 い ①) で scaleX、rotationConcat、BlendMode な どの プロ パテ ィ を 使用 し て いま す 。 
すべ て の Motion オ ブ ジ ェクト で duration=10 と し て いま す が 、addPropertyArray() の 第 2 パ 
ラメ ー タ に 渡す 配列 の 要素 数 が 10 に 満た な い 場 合 、 最 後 の 値 が 10 フ レー ム 目 まで 継続 し ます 。 
@② で addTarget() に より 、 タ ー ゲ ッ ト オ ブ ジ ェクト を 設定 し て いま す が 、2 番 目 の パ ラメ ー タ で 
アニ メー ショ ン を 繰り 返す 回 数 を 指定 し て いま す 。 そ れ ぞ れ 1、2、3 回 実行 し て 停止 し ます 。 


モー ショ ント ウゥ イー ン で ブ ィ ルター 
と ニン ジス うな 有 まっ 





Motion ク ラス と AnimatorFactory ク ラス に る トゥ イー ン ア ニメーション に フィ ルター を 追 
加 す る 場合 、 ア ニメーション と 同様 に 配列 に よる 指定 を 行い ます 。 指 定 は 、 事 前 に initFilters() 
メソ ッ ド に よる 初期 化 を 行い 、addFilterPropertyArray() メ ソ ッ ド で フィ ルター の 設定 を 行い 
ます 。flash.filters パ ッ ケ ー ジ の フィ ルター を 使用 で きま す 。 


乱 ActionScript の フィ ルター に よる モー ショ ント ウゥ イー ン の 作成 手順 


使用 する プロ パテ ィ / メ ソ ッ ド 
時 間 を 設定 する duration プ ロ パ ティ 


使用 する フィ ルター すべ て の 完全 修飾 クラ | initFilters() メ ソ ッ ド 
ス 名 か ら な る スト リン グ 配 列 を 作成 し 、 初 
期 化 を 行い ます 。 








アニ メー ショ ン の 基本 と な る フィ ルター を | addFilterArray0 メ ソ ッ ド 


5 AnimatorFactory オ ブ ジ ェクト を 作成 する | コン スト ラク タ に Motion オ ブ プ ジ ェ クト を 渡し ます 。 


アニ メー ショ ン を 適用 する イン スタ ンス を | addTarget0 メ ソ ッ ド 
設定 する 








乱 flash.filters バ ッ ケ ー ジ の フィ ルター クラ ス 


フィ ルター の 内 容 


表示 オブ ジェ クト に ベ べ ベ ル 効 果 を 追加 で きま す 。 


すべ て の イメ ー ジ フィ ルター 効果 の 基本 クラ ス で す 。 


BitmapFilter オ ブ ジ ェクト の レン ダリ ング 品質 を 設定 する 値 が 含ま 
れ ま す 。 


BitmapFilter の 型 を 設定 する 値 が 含ま れ ま す 。 
表示 オブ ジェ クト に ぼかし 効果 を 適用 で きま す 。 


入力 イメ ー ジ の 各 ピ クセ ル の RGBA カ ラー 値 と アル ファ 値 に 4x5 マ 
トリ ックス 変換 を 適用 する こと で 、 新しい RGBA カ ラー 値 と アル ファ 
値 か ら な る 結果 を 作成 で きま す 。 


ConvolutionFilter マト リッ クス 畳み 込み フィ ルター 効果 を 適用 で きま す 。 


DisplacementMapFilter 指定 され た BitmapData オ ブ ジ ェクト (置き 換え マッ プイ メー ジ と い 
いま す ) の ピク セル 値 を 使用 し て 、 オ ブ ジ ェクト の 置き 換え (変位 ) 
を 実行 し ます 。 


DisplacementMapFilterMode | DisplacementMapFilter ク ラス の mode プ ロ パ ティ の 値 を 提供 し ま 
す 。 











BevelFilter 








BitmapFilter 








BitmapFilterQuality 













BitmapFilter Type 





BlurFilter 





ColorMatrixFilter 
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外 flash.filters パッケージ の フィ ルター クラ ス (続き ) 


クラ ス フィ ルター の 内 容 


DropShadowFilter ドロ ッ プ シャ ドウ を 表示 オブ ジェ クト に 追加 し ます 。 
GradientBevelFilter オプ ジェ クト に グラ デー ショ ン ベ ベ ル 効 果 を 適用 し 、 表 示 で きま す 。 
表示 オブ ジェ クト に グラ デー ショ ング ロー 効果 を 適用 で きま す 。 


フィ ルター 処理 され る オブ ジェ クト に シェ ー ダ を 実行 する こと に 
よっ て フィ ルター を 適用 し ます 。 




















GradientGlowFiler 






ShaderFilter 











息 Motion ク ラス の フィ ルター の た め の プ ロ パ ティ 詳細 


プロ パテ ィ | プロ パテ ィ の 詳細 


duration | Motion オ ブ ジ ェクト が 持つ フレ ー ム 数 を 表し ます 。 通常 は この 値 を 最大 値 と する フィ ル 
: 1n 上 ター プロ パテ ィ 値 の 配列 を addFilterPropertyArray() メ ソ ッ ド の 第 3 パラ メー タ に 渡し 
て フィ ルター プロ パテ ィ 値 の 変化 を 定義 し ます 。 配列 の 要素 数 が duration よ り 小 さい 場 
合 、 配 列 の 最後 の 要素 の 値 が 最後 の フレ ー ム まで 維持 され ます 。 

















筆 Motion ク ラス の フィ ルター アニ メー ショ ン の た め の メ ソ ッ ド 詳細 


1initF1i]1ters Motion オ ブ ジ ェクト に 適用 する フィ ルター クラ ス を 定義 し ます 。 
(E11terClagge8g : A エ raY , 適用 する フィ ルター クラ ス 名 を 配列 に し て パラ メー タ に 渡し ます 。 
gradientSubarrayLengths: | 側 terClasses : 使用 する フィ ルター の 完全 修飾 クラ ス 名 を String 
Array , StartFrame : 1nt = で 配列 に し て 渡し ます 。 

9 gradientSubarrayLengths : 使用 する フィ ルター が Gradient 
endFrame : nt = -1) GlowFilter ま た は GradientBevelFilter で ある 場合 、 コ ンス トラ 
: vo1d クタ の colors.alphas,rattions パ ラメ ー タ を 初期 化す る 配列 の 長 さ 
を 指定 し ます 。 

startFrame/endFrame : 初期 化 を 適用 する フレ ー ム を 指定 する 
場合 、Motion オ ブ ジ ェクト の 開始 / 終 了 フ レー ム を 対象 に し ます 。 
デフ ォ ル ト は 全 フ レー ム 対 象 で す 。 


Motion オ ブ ジ ェクト に フィ ルター プロ パテ ィ を 設定 し ます 。 
index : initFilters() メ ソ ッ ド の 第 1 パラ メー タ に 設定 し た 配列 の 
イン デック ス に より 、 使 用 する フィ ルター を 指定 し ます 。 例 えば 
InitFiters(["flash.filters.BevelFiltter"、"flash.filters.Glow 
Filter],.…) と し た 場合 、 0 : BevelFilter、1 : GlowFilter を 表し ます 。 
name : 使用 する フィ ルター の プロ パテ ィ 名 を 指定 し ます 。 
values : Motlon オ ブ ジ ェクト の キー フレ ー ム ご と に 適用 する 
フィ ルター プロ パテ ィ 値 を 配列 に し ます 。 配列 の 要素 数 が dura 
tion プ ロ パ ティ で 指定 され た 男 囲 より 小さ い 場 合 、 最 後 の 要 素 の 
値 が 継続 され ます 。 
startFrame、endFrame で 適用 する 開始 / 終 了 フ レー ム を 設定 で 
きま す 。 開始 フレ ー ム は 0、-1 を 指定 する と 先頭 フレ ー ム か ら 適 
用 され ます 。 




























adQdF 1 ] 上 G エ ピエ 〇 DG エ ヒ YA エ エ a マ Y 
( hndex : 1n , 
name : S 上 1n , 
Val1u@e8 : A エ エ aY ツ , 
StartFrame:1nE = -1, 
enQFram@ : hn 七 = -1) :Yo1d 


























ーー 
モー ショ ント ゥ イー ン で フィ ルター アニ メー ショ ン を 作成 する 


符 AnimatorFactory クラ ス の メソ ッ ド 詳細 


addTarget Motion オ ブ ジ ェクト を 表示 オブ ジェ クト に 適用 し ます 。 こ の 
(target :DisplayOb]j ect , メソ ッ ド で 指定 され た 表示 オブ ジェ クト に Motion オ ブ ジ ェ ク 
repeatCount:int = 0, ト が 持つ フィ ルター が 実行 され ます 。 

autoP1ay : Boo1ean = rue, target : トゥ イー ン を 適用 する 表示 オプ ジェ クト 
gtartFrame:1nt = -1, repeatCount : フィ ルター の リピ ー ト 回 数 で す 。0 (デフ ォ ル 



































useCurrentFrame : Boolean = ト ) で は 無限 に 繰り 返し ます 。 
Fa]se autoPlay : true の 場合 、 フ ィ ル ター トゥ イー ン を 自動 で 開始 
) : AnimatorBase し ょ 家 ます 


startFrame : 親 の タイ ムラ イン を 基準 と する 、 ア ニ メ ー シ ョ 
ン が 開始 する フレ ー ム で す 。 

useCurrentFrame : true の 場合 、 ター ゲッ ト オ ブ ジェ クト を 
配置 する アニ メー ショ ン フ レー ム を 決定 する 親 の current 
Frame プ ロ パ ティ を 使用 し ます 。 


ニコ 
で 





レン の EMCJ 
CE さ で 7 
^ 





= が 1 上 首 叶 m1 ヨ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


フィ ルター に よる アニ メー ショ ン MotionTweenSampleC.fla 


1mport Ff] .mo1on .An1maOrFaco ヒ OrY: 
1mport Ff] .mot1on .Mot1onBa86e : 
1mport Ff] .mot1on .Mo1On : 


1mport Flash .F11ter8g.*: 


//1. Motionm オ ブ ジ ェクト を 作成 


Yar myMotion1 :Mot1on = new Mot1on ( ) : 


/ / 2 . 時 間 を 設定 


myMotion1 .duration = 8: 


//3 . フィ ルター を 初期 化 
myMot1on1 . 1n1tF11ters(["Elash.F1l1ters .DropShadowF11ter", "FE]1ash . 
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Fi]terg .B1urF1]1er リ ] / [0, 0, 0] ) err 


//4 . アニ メー ショ ン の 基本 と な る プロ パテ ィ を 設定 

/ /myMotion1 . adQEF11EerPrODertyArray(0, "anqgle", [0, 20, 40, 60, 
80, 160。 220, 280,。 330。 340, 350, 360] 1 : 

myMo ュ on1 . addF11t 上 erPrODertyArray(0, "angle", [0, 180, 0, 180, 0, 
220。 ひ 。 90] ) : 

myMot1on1 . addF11terPropertyArray(0, "ocolor", [OxFF0000, 0x00FEF00, 
0x444444, Ox0000FF, Ox888888, Ox660000, Ox444444, 0x006600] ) 
myMotion1 . addF11terPropertyArray(1, "bl1urX", [0, 2, 8, 16, 0]): 
myMot1on1 . addF11EerPrOpertyArray(1, "blurY", [0, 0, 0, 0, 0, 2, 
き 。 16。 01 ) : 





//5. AnimatorFactory オ ブ プ ジ ェ クト を 作成 
Yar myAf1 :An1matOrFacCEory = new An1matorFacory( myMotion1 ): 


//6 . アニ メー ショ ン を 適用 する イン スタ ンス を 設定 

myAf1 .addTarget ( target01 ): 

myAf1 .addTarqget ( tarqet02 ): ③ 
myAfF1 .addTarget ( tarqdet03 ): 


の initFilters() メ ソ ッ ド で 使用 する 2 つの フィ ルター (DropShadowFilter、BlurFilter) を 
初期 化し て いま す 。⑧ で フィ ルター プロ バテ ィ の 設定 値 に よる アニ メー ショ ン を 作成 し て いま 
す 。addFilterPropertyArray() メ ソ ッ ド の 第 1 パラ メー タ が 0 の 場合 、 DropShadowrFilter が 
1 の 場合 、BlurFilter の プロ バテ ィ 設 定 に な り ま す 。3③ で ステ ー ジ 上 の 3 つの オブ ジェ クト に ア 
ニメーション を 適用 し て いま す 。 


昌 BlurFilter プロ / ヴ ィ 3 ーー に に に < ーー の ィ に よる 変化 


アー 制御 ( 〇 ) デル バッ グ (D) ァイル 0D あの (C デック 0 





7 - 8 IK( イ ン バ ー ス ・ キ ネ マ ティ ックス ) 
fLik パッケージ を 使う 





Flash CS4 か ら 利 用 可能 に な っ た IK (イン バー ス ・ キ ネ マ ティ ックス ) は 骨 (ボー ン ) と 関節 で 
構成 され る 自然 な アニ メー ショ ン を 提供 する テク ノロ ジー で す 。ActionScript で IK の 制御 を 行 
う 場 合 、 ま ず オ ー サ リン グ 環 境 で アー マチ ュ ア (つなが っ た ポーン 全 体 ) を 作成 し ます 。Avction 
Script に よる IK オ ブ ジ ェクト の 作成 は で きま せん 。ActionScript で IK の 制御 を 行う た め に fl.ik 
パッ ケー ジ が 用 意 さ れ て いま す 。IKArmature ク ラス は アー マチ ュ ア オブ ジェ クト を 表す クラ 
ス で 、IKArmature オ ブ ジ ェクト は ボー ン と ジョ イン ト で 構成 され ます が 、 ボ ー ン は IKBone、 
ジョ イン ト は IKJoint ク ラス の イン スタ ンス に な り ま す 。IKManager ク ラス は アー マチ ュ ア オ 
ブ ジ ェクト の 情報 を 取得 する た め の プ ロバ ティ と メソ ッ ド を 提供 し ます 。ActionScript で アー 
マチ ュ ア の 情報 を 参照 する に は | 実行 時 ] オプ ショ ン を 設定 し て お く 必 要 が あり ます 。 


共和.ik バッ ケー ジ の クラ ス 
すべ て の アー マチ ュ ア オブ ジェ クト を 管理 し ます 。 


IKArmature | イン バー ス ・ キ ネ マ ティ ックス (IK) アー マチ ュ ア を 表し ます 。 ア ー マ チ ュ ア は Flash オ 
ー サ リン グ ツ ー ル で の み 作 成す る こと が で きま す 。 






IKBone アー マチ ュ ア の 基本 コン ポー ネン ト セ グ メ ント で ある 「 ボ ー ン 」 を 表し ます 。 ボ ー ン は 
IKJoint オ ブ ジ ェクト で 互い に 接続 され ます 。 


IKEvent アー マチ ュ ア に 関す る イベ ント を 定義 し ます 。 


IKJoint 2 つの ボー ン の 接続 部 を 定義 し 、 ボ ー ン の 接続 方 法 や 動作 に 関す る プロ パテ ィ を 提供 し 
ます 。 



































IKMover アー マチ ュ ア の 動作 に 関す る プロ パテ ィ と 実行 する メソ ッ ド を 提供 し ます 。 











弄 IK の 主 な オブ ジェ クト 


IKBone オブ ジェ クト 
IKArmature オブ ジェ クト 


IKJoint オ ブフ ジェ クト 
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7-8 
IK( イ ン バ ー ス ・ キ ネ マ ティ ックス ) 


再 | 初 区 訟 定 * [の | ー 日 ※ 


簡 オー サ リン グ 時 の アー マチ ュ ア オブ ジェ グ ト の オプ シ ョ ン 設 定 


ファ イル (9 栖 衝 人 表示 W 挿入 修正 MM テキ スト (D コマ ンド (G 選 邊 (0) デバ ッ グ (DD ウィ ンド ウ WD ヘル プ 60 


| 


SNwS NN ほし ノコ で を 芋 マ 負 


- 


\N と 


SO DO.x 国語 


②[ オ プシ ョ ン ] タブ の [種類 ] を | 実行 時 ] に する 





① ボ ー ン ツー ル で 作成 され た アー マ 
チュ アレ イヤー を 選択 





委 IKManager ク ラス の 主 な プロ パテ ィ 概 要 


存在 する アー マチ ュ ア 数 を 調べ る ステ ー ジ 上 の アー マチ ュ ア の 数 を 表し ます 。 
:・ 1m ヒ 


符 IKManager ク ラス の 主 な メソ ッ ド 概要 


イン デック ス を 指定 し | getArmatureAt ( [static] 指 定 の イン デック ス 位 置 の 
て アー マチ ュ プ デオ ゾ プ ブ | iQext:nE デー ダナ ュ ア 才 志 し ます 。 
ジェ クト を 取得 する ) : TKArmatu エ e 





名 前 を 指定 し て アー マヤ | qetArmatureByName ( [static] 指 定 さ れ た 名 前 を 持つ アー 
チュ アオ ブ ジ ェクト を | name : String マチ ュ ア を 返し ます 。 
取得 する ) : TKArmature 





fl.ik パッ ケー ジ を 使う 


特 IKManager ク ラス の 主 な メソ ッ ド 概要 (続き ) 


メソ ッ ド 名 メソ ッ ド の 概要 


すべ て の アー マチ ュ ア の ライ プ ブ ト 
ラッ キン グ を 有効 また は 無効 に し 
ます 。 


指定 され た IKArmature イ ンス タン 
ス の ライ ブ ト ラッ キン グ を 有効 ま 
た は 無効 に し ます 。 

旧 定 され た IK 表 示 オ ブ ジ ェクト イ 
ンジ スタ ンス の ライ ブ プ ト ラ ッ キ ング 
を 有効 また は 無効 に し ます 。 


















rackA] 1Armature8g ( 
enab1e : Boolean=TUue ) :YO 〇 1d 


ー マ チ ュ ア の ライ ブ 
トラ ッ キ ング を 有効 / 
無効 に する 



























了 aCKTKArmau エ 6 | 
theTree : TKArmature, enab」1e: 
Boolean = ue) :VO1d 





LraCKTKODb] ecCt 
tarqdet : DisplayOb] ec , 
enable : Boolean = TUGe) :* 











息 IKArmature クラ ス の 主 な プロ バテ ィ 概 要 


name この アー マチ ュ ア オブ ジェ クト の 名 前 を 表し ます 。 
: S 上 1nd 


この アー マチ ュ ア オブ ジェ クト の ルー ト ジ ョ イ ント (関節 ) 
を 表し ます 。 















roOoO 上 Jonnt 
・ TKJO ュ 1n ロ ヒ 


ルー ト ジ ョ イ ント を 参照 





息 IKArmature クラ ス の 主 な メソ ッ ド 概要 


メソ ッ ド 名 


etBoneByName ( 
tarqdetName : S 上 エエ 1nd 
) : TKBOne 






メソ ッ ド の 概要 


targetName で 指定 し た ボー ン オ 
ブ ジ ェクト を 取得 し ます 。 












ボー ン を 名 前 で 取得 
する 

















ライ ブラ リシン ボル 
イン スタ ンス の IK 移 
動 を アク ティ イブ 化 


red18SterElement8g ( 
staqge :D1splayOb] ecCt 上 Conta1ner 


尋 


ーー マチュア を 含む MovieClip ラ 
イブ ラリ を 実行 時 に イン スタ ンス 
化す る 場合 、 こ の メソ ッ ド を 呼び 
出し ます 。 









| 






呈 A 人 MP し LE 計 EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


IKNode02 


IKBone02 


IKNode01 
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7-8 
IK( イ ン バ ー ス ・ キ ネ マ ティ ックス ) 


= あす 1 画 = 幸 本 mp】 コ 蘭 ------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


ステ ー ジ 上 の アー マチ ュ ア の 数 と 名 前 リス ト を 取得 する IKSampleB.fla 


JOOF 下す 3K.*: 
PART ゞ a arTmm : TKATmatu エ 6 : 
Var OOotJoinrt : TKJoin : 
ar ご CU エエ en 二 り ont : TKJoin : 
Var Donme : TKBone : 
Yar numChi1dren :1n : 
/ / TKArmature オ ブ ジ ェクト を 調べ る 関数 
Function qetArmature ( ) :Yoid { 
Va 1 ユ 1:1n : 
traoce( "TKArmature オ ブ ジ ェクト の 数 :" + TKManager . numArmatures ): 一 ーーーー① 
for ( ュ = 0O : 1 < TIKManager .numArmature8 : ユ ++ ) { 
arm = TKManaqer .detArmatureA ヒ ( 1 ): 
// ル ー ト ジョ イン ト オ ブ ジェ クト を 取得 


OOtJoirn = arm.rOoOtJoirn : 





detJointg ( rootJoirt ): 


) 
// TKJToint 上 オブ ジェ クト と TKBone オ ブ ジ ェクト を 調べ る 関数 


Fumction qetJoinEgs( ]:TKJoint ) :vo1d { 一 一 ーーーーーーーーーーーーーーーーーーー ③) 


Va 1 ユ :1n : 


trace ( " ぎ \ ぎ nm ジョ イン ト 名 :" + ].name + ", numChi1dren=" + ].numChi1dren ): 
bone = ].bone: 

④ 
trace( "ボー ン 名 :" + bone .name ): 
for ( += ェ Oz:i< ]].numChi1dren : 1++ ) 1 


Cu エ reGnJont = TKJoint ( ].qetChi1dAt( 1 ) ): 
if ( currentJoint .numChi1dren == 0O ) 


traoe ( " ぎ \ ぎ mn ジョ イン ト 名 :" + currentJoint .name + ", numChi1dren=" 


⑥ 


+ CUu エ YentJoirnt .numChi1qdren ): 


traoe ( "ポーン 名 :" + CurrentJoint . bone .name ): 


) 


if ( TKJoint( ].getChi1qdAt( 1 ) ) .numChi1dren > 0 ) { 
etJoints ( TKJoint( ].getChi1qdAt( 1 ) ) ): 
) 
) 
) 
detArmature ( ) : 
8tOP () : 
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7-8- 1 
fl.ik パッ ケー ジ を 使う 


ステ ー ジ 上 の IKArmature オ ブ ジ ェクト と その 関連 する オブ ジェ クト を 抽出 する サン プル で 
す 。 ま ずい ① で 行っ て いる よう に 、IKAamature オ ブ ジ ェクト の 数 を 調べ る に は 、numChild 
ren プ ロ パ ティ を 使用 し ます 。② の for 文 で すべ て の オブ ジェ クト に つい て 調べ て いま す 。 癌 
IKArmature オ ブ ジ ェクト に は ルー ト ジ ョ イ ント オブ ジェ クト が あり 、 そ れ を 元 に し て 関連 す 
る ジョ イン ト と ボー ン を 調べ る こと が で きま す 。 IKArmature オ ブ ジ ェクト の rootJoint プ ロ 
パテ ィ で ルー ト と な る IKJoint オ ブ ジ ェクト を 取得 で きま す 。 ルー ト ジ ョ イ ント か ら 関 連 す る 他 
の ジョ イン ト 、 ボ ー ン を 抽出 する に は 、getChidAt() メ ソ ッ ド で 調べ る こと が で きま す 。 そ の 
た め の 関 数 は ③ 以 降 の getJoints() 関 数 で す 。 ジ ョ イン ト に 関連 づけ され た ボー ン は 、(④ で 行っ 
て いる よう に 、IKJoint オ ブ ジ ェクト の bone プ ロバ ティ で 調べ る こと が で きま す 。getJoints() 
関数 内 で は 、 パ ラメ ー タ で 与え られ た ジョ イン ト が 子 を 持つ 場合 、 再 び 同 じ getJoints() 関 数 を 


呼び 出し て 処理 し て いま す が 、 最 後 の ジ ョ イン ト で は numChildren プ ロバ ティ が 0 と な る た め 、 


⑤ の よう に 情報 を 出力 する よう に し て いま す 。 以上 の 処理 に より 、IKArmature オ ブ ジ ェクト 
内 の IKJoint、IKBone オ ブ ジ ェクト を 抽出 し て いま す 。 こ の サン プル で は 、 ス テー ジ 上 に 作成 
し た オブ ジェ クト に 次 の よう な 名 前 を つけ て いま す 。 IKNodeXX と いう 名 前 を つけ た ノー ド 名 
と 同じ 名 前 が ジョ イン ト 名 と し て 参照 され ます 。 


実行 結果 (トレ ー ス 出力 ) 
TKArmature オ ブ プ ジ ェ クト の 数 :1 


ジョ イン ト 名 :1ikNode01 , numChi1dren=1 
ボー ン 名 :1kBoneName9 


ジョ イン ト 名 :1kNode02, numChi1dren=1 
ボー ン 名 :1kBone01 


ジョ イン ト 名 :1kNode03, numCh1i1dren=0 
ボー ン 名 :1kBone02 


[オプ ショ ン ] タブ の [種類 ] を 「 オー サリ ング 時 」 で 実行 し た 場合 、 次 の よう な 結果 に な り ま す 。 


TKArmature オ ブ ジ ェクト の 数 :0 


PART 


の 5 と 


ActionScript で 
アー マチ ュ ア を 動か す 





fl.ik パ バッ ケ ー ジ の クラ ス を 利用 し て アー マチ ュ ア オブ ジェ クト を 取得 し 、 動 か すこ と が で き 
ます 。 了 誠 滞 蘭 で 解説 し た よう に 、 作 成 時 に 名 前 を つけ て お く と その 名 前 で オブ ジェ クト を 参照 
する こと が で きま す 。 名 前 は オー サリ ング 中 に ステ ー ジ 上 の オブ ジェ クト を 選択 し て プロ パ 
ティ イン スペ クタ で 入力 し ます 。 ま た 、ActionScript で アー マチ ュ ア を 動か す た め に は 「 実 行 
時 ] オプ ショ ン を 設定 し て お く 必 要 が あり ます 。 手順 は 次 の よう に な り ま す 。 


特 ActionScript で IK の 制御 を 行う 手順 


使用 する 主 な クラ ス 
オー サリ ング 環境 で ボー ン ツ ー ル に より アー マチ ュ ア を 作成 し て 名 前 を つけ 
る 。 プ ロ パ ティ イン スペ クタ で 実行 時 」 オプ ショ ン 設 定 を 行う (下図 参照 )。 


IKArmature 
IKManager 


IKBone 
IKJoint 














IKMover 
IKEvent 





圏 オー サリ ング 時 の アー マチ ュ ア オブ ジェ クト の 名 前 づけ と 設定 
| 初 隊 論 定 *|「 わ D 。 | = ゼ x 
ファ イル () 編集 表示 W 挿入 @ 履正 IMW デキ スト (D コマ ンド (C 到 御 (0) デバ ッ グ (D) ウィ ンド ウ W)D ヘル プ (H 


少 SampleA- 和 ia 





全品 






操作 する ジョ イン ト 、 ボ ー ン を 
選択 し て 名 前 を 付け て お く 









[オプ ショ ン ] タブ の [種類] を 
[実行 時 ] に する 





| ge 園 > 国 、 と CNwCS NN ロン ノン コン で と 基 ヶ 局 議 





アー マチ ュ ア レイ ヤー を 選択 


7-8-2 
ActionScript で アー マチ ュ ア を 動か す 


矯 IKBone クラ ス の 主 な プロ パテ ィ 概 要 


プロ パテ ィ 名 | プロ パテ ィ の 概要 
kamu 還 議 


name この ボー ン オ ブ ジ ェクト の 名 前 を 表し ます 。 
: S 上 エ 1nd 
2 I ダ ョ イツ ト / デ ー 


heaqdJoint | この ボー ン の 2 つの ジョ イン ト の うち 、 ル ー ト に 近い ヘッ ド 



















ル ジ ョ イン ト を 参照 : TKJoin セ ジョ イン ト と 逆 側 の テイ ル ジ ョ イン ト を 表し ます 。 
ta11Join 
: TKJOo1n キ 


馴 IKJoint ク ラス の 主 な プロ パテ ィ 概 要 










mo 


ジョ イン ト が 関 | bone この ジョ イン ト オ ブ ジェ クト が 関連 する ボ 
連 す る ボー ン : TKBone 













ー ン を 表し ます 。 


ジョ イン ト オ ブ | name この ジョ イン ト オ ブ ジェ クト の 名 前 を 表し 
ジェ クト の 名 前 | :8String ます 。 


ジョ イン ト の 位 | position この ジョ イン ト オ ブ ジェ クト の 座標 を 表し 
置 する 現在 位置 ます 。 座標 を 直接 変更 する こと は で きま せ 
座標 ん 。 


回 転 の 現在 値 rota1on 現在 の 回 転 値 を 表し ます 。 回 転 値 は オブ 
: Number ジェ クト の 移動 に より 、 自動 的 に 決ま り ま す 。 
回 転 を 制限 され | rotationContrained 回 転 の 最大 値 / 最 長 値 が 設定 され て いる か を 
て いる か : Boo] ean 示し ます 。 
回 転 が 有 効か rotationEnab1ed 回 転 が 有 効か 無効 か を 示し ます 。 
: Boolean 
回 転 の 最大 値 / | rotationMax/rotaionMin 回 転 の 最大 値 / 最 長 値 を 表し ます 。 
最小 値 : Number 


回 転 速 度 を 制限 | spesd ボー ン の 動き の 速度 を パー セン ト 値 で 制限 
: NumDer し ます 。 デ フォ ルト は 100 (%) で 、 こ れ は 
無制限 を 表し ます 。 


x 方 向 /y 方 向 へ | xTrans1ation/yTrans1ation x 方 向 /y 方 向 へ の 移動 の 現在 値 を 表し ます 。 
の 現在 の 移動 値 | :Number 直接 この プロ パテ ィ の 値 を 変更 で きま せん 。 


x 方 向 /y 方 向 へ の 移動 最大 値 / 最 小 値 が 設定 
され て いる か を 示し ます 。 





プ 
を 























x 方 向 /y 方 向 へ | xTrans1ationconstraimned/ 
の 移動 が 制限 さ | yTrans1at 上 ionCong 上 rained : 
れ て いる か Boo1 ean 


x 方 向 /y 方 向 へ | xTrans1ationEnab1ed/ x 方 向 /y 方 向 へ の 移動 が 有効 / 無 効 を 示し ま 
の 移動 が 有効 か | yTrans1ationEnab1ed 鹿 。 
: Boolean 


























x 方 向 /y 方 向 へ | xTrans1ationMax/ 
の 移動 最大 値 / | yTrans1ationMax 
最小 値 : Number 


ジョ イン ト 動 作 | DDF ROTATTON : int 
の 制限 の 種類 を | DDE XTRANS : int 
DDF YTRANS : int 





x 方 向 /y 方 向 へ の 移動 最大 値 / 最 小 値 を 示し 
ます 。 





















回 転 を 制限 する こと を 示し ます 。 
X 方 向 へ の 移動 を 制限 する こと を 示し ます 。 
Y 方 向 へ の 移動 を 制限 する こと を 示し ます 。 
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7-8 


IK (インバー ス ・ キ ネ マ ティ ックス ) 


重 IKJoint ク ラス の 主 な メソ ッ ド 概要 


ジョ イン ト の 動き を 制限 


PART 


ジョ イン ト の 動き を 有効 
/ 無 効 


ジョ イン ト の 動き が 制限 
され て いる か 


getConstrained dof で 指定 し た 要素 に 対す る 制限 を 有効 / 無 効 
(dof : int, enab1e: に し ます 。 dof は IKJoint ク ラス の 定数 で 指定 で 
Boo1ean ) :* きま す 。 


setEnab1ed (dof :int, | dof で 指定 し た 要素 に 対す る 有効 / 無 効 を 設定 
enab1 e : Boo]ean ) :* し ます 。dof は IKJoint ク ラス の 定数 で 指定 で き 
近 ま 。 


igEnab1] ed (dof : dof で 指定 し た 自由 度 の 設定 が 有効 に な っ て い 
1n ) :* る か どう か を 返し ます 。 





怠 IKMover ク ラス の 主 な プロ パテ ィ 概 要 


IK ジ ョ イン ト を 移動 で き 
る 最大 距離 を 制限 


1 回 の 移動 で の 最大 繰り 
返し 回 数 を 制限 


移動 を 実行 する 最大 時 間 
(ミリ 秒 単位 ) を 指定 


distanceLimit 値 を 超え 
た 後 、IK エ ンジ ン が 移動 
を 終了 する か どう か 


iterationLimit 値 を 超え 
た 後 、IK エ ンジ ン が 移動 
を 終了 する か どう か 

指定 され た timeLimit を 
超え た 後 、IK エ ンジ ン が 
移動 を 終了 する か どう か 





distanoceLiimit : Number IK エ ンジ ン が IK ジ ョ イン ト を 各 反 復 処 
理 で 移動 する 最大 距離 (ピク セル 単位 ) 
ぜ す 。 


iterationL1imit : nt IK エ ンジ ン の IK ジ ョ イン ト の 1 回 の 移動 
で の 最大 繰り 返し 回 数 を 指定 し ます 。 


timeLiimit : nt IK エ ンジ ン が IK ジ ョ イン ト 移 動 を 実行 
する 最大 時 間 ( ミ リ 秒 単位 ) を 指定 し ます 。 


1imitByDistance : Boo1ean | distanceLimit 値 を 超え た 後 、IK エ ンジ 
ン が 移動 を 終了 する か どう か を 指定 し 
ます 。 


11m1itByTteration : iterationLimit 値 を 超え た 後 、IK エ ンジ 
Boo1ean ン が 移動 を 終了 する か どう か を 指定 し 
ます 。 


11m1tByT1me : Bool1ean 指定 され た timeLimit を 超え た 後 、IK エ 
ンジ ン が 移動 を 終了 する か どう か を 指 
定 し ます 。- 


多 IKMover ク ラス の 主 な メソ ッ ド 概要 


IKMover オ ブ ジ ェクト 
を IKJoint オ ブ ジ ェクト 
と 関連 づけ る 


IK ジ ョ イン ト を 移動 する 
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TKMover ( コン スト ラク タ の 第 1 パラ メー タ に IKJoint 
endEffector : TKJo1nt, | オブ ジェ クト を 渡し て 関連 づけ で きま す 。 
tarqdetTn : Poin ) 


moveTo ( すべ て の 関連 する IKJoint オ ブ ジ ェクト を |IK 

tarqgetTn : Poin) 制約 に 基づい て 更新 し 、 関 連 付 けら れ た 

: IKJoint オ ブ ジ ェクト を ター ゲッ ト ポ イ ント 
に 移動 させ ます 。 





7-8-Z 
ActionScript で アー マチ ュ ア を 動か が す 


GANIPLF 0 







この ジョ イン ト を 動か す 


IKBone オブ ジェ クト 名 : targetBone 





= 上 =] 画 = 疾 中 mp】 コ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


IK アー マチ ュ ア を 動か す KSampieB.fla 





TRIOOYE f」、 エ K. テ : 


Var am : TKATmatu エ 6 : 
Var 上 ardetBoOne : TKBOne : 
Var tardetJoirnt : TKJo1n : 


Va 1km: TKMover : 


Function 1nit () :vo1d { 
arm = TKManaqer .detArmatureA モ ( 0 ): 
/ / 名 前 で TKBone オ ブ ジ ェクト を 取得 
tarqdetBone = arm.qgetBoneByName( "tarqgetBone" ): 
// て KBone オ ブ ジ ェクト の ルー ト と 逆 側 の TKJoint オ ブ ジ ェクト を 取得 
tardetJoin = targetBone . ta1] JO1n 七 : Ni 
/ /targetJoint の 現在 の 位置 を 基点 と する TKMover オ ブ ジ ェクト を 作成 和 
1km = new TKMOoVer ( tarqdetJon , 上 ardetJoinE .Do81t1on ): | 
/ / | 伸ばす 」 ボ タン と 「 曲 げ る ] ボ タン の イベ ント リス ナー 登録 


b1 btn .addEventListener( MouseEvert .CLTCK, moVveForward ): 


⑯ 


b2 btn .addEventListener( MouseEvent .CLTCK, moveBack ): 


/ /「 伸 ば ず す 」 ア クシ ョ ン 
Funotion moveForward (event : MouseEven ) : vo1d 1 


Var pt : Po1n = tarqgetJoint .DO81 ヒ 1On : | 
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7-8 
IK( イ ン バ ー ス ・ キ ネ マ ティ ックス ) 


// ジ ョ イン ト の 位置 を x : 10、Y:10 移 動 さ せる 
1km.moveTo( new Point( pt 上 .xx + 10, pt 上.Y+ 10 ) ): ③ 


) 


/ /「 曲 げ る 」 ア クシ ョ ン 

Funotion moveBack (event : MouseEvent ) :void { 
Ya pt : Po1n = tarqdet 上 Jo1n .DO81 キ 1On : 
// ジ ョ イン ト の 位置 を x : -10、y: -10 移 動 させ る ⑨ 
1km.moveTo( new Point( pt.x - 10, pt.yY - 10 ) ): 

) 

1ni () : 


StOD ( ) : 


サン プル で は 、3 つ の ジョ イン ト の うち 、 先 端 の こ 点 し 部 分 の 位置 を プロ グラ ム で 変更 し ます 。 


アー マチ ャ アオ ブ ジ ェクト の 先端 部 分 を 動か す と ルー ト 方 向 の ボー ン と ジョ イン ト が 連動 し て 
動作 し ます 。 こ 点 し 部 分 の ジョ イン ト オ ブ ジェ クト を 得る た め に 必要 と な る の は 、 そ の ジョ イ 
ント に 連結 され た ボー ン の 名 前 で す 。 こ れ は 、IKArmature ク ラス に getBoneByName() メ 
ソ ッ ド が あり 、Bone ク ラス に tailJoint プ ロ パ ティ が ある た めで す 。 


ゆり で それ ら に よる ジョ イン ト オ ブ ジェ クト の 取得 を 行っ て いま す 。 タ ー ゲ ッ ト の ジョ イン ト 


が 取得 で きた ら 、IKMover オ ブ ジ ェクト を 生成 し ます 。 


⑧② で 行っ て いる よう に 、 コ ンス トラ クタ の 第 1 パラ メー タ に ター ゲッ ト の ジョ イン ト 、 第 2 パ 


ラメ ー タ に 基準 と な る 最初 の 位置 を Point オ ブ ジ ェクト で 指定 し ます 。 こ こ で は 、 現 在 の ジョ 
イン ト の 位置 を 、IKJoint オ ブ ジ ェクト の Position プ ロバ ティ で 取得 し て 設定 し て いま す 。 実 
際 の アク ショ ン は 、3③ と (④ の 関数 で 行っ て いま す 。IKMover オ ブ ジ ェクト の moveTo0) メ ソ ッ 
ド で 、 動 か す 先 の 座標 を 指定 する と 、 目 的 の ジョ イン ト が 移動 し 、 関 連 す る ボー ン と ジョ イン 
ト が 連動 し ます 。 


『 


『 





シン IkSampleB.swf 
ファ イル (PF) 表示 (V) 挟 件 (CO デバ ッ グ (D) 








| ikSampleB.swf 


| 愛 ikSampleB、gwf 
ファ イル (F) 表示 (y) 局 御 (CO デバ ッ グ (D) 








ファ イル (FE) 表示 (V) 司 御 (CO デバ ッ グ (D) 








7-8-2 
ActionScript で アー マチ ュ ア を 動か す 


の 57 


PART 
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IKEvent を 使う 





IKMover オ ブ ジ ェクト に よる IK オ ブ ジ ェクト の 移動 に 伴い 、IK イ ベン ト が 発生 し ます 。 イ ベ 
ント は IKMover オ ブ ジ ェクト の プロ パテ ィ で 指定 し た 移動 距離 、 回 数 、 時 間 を 超過 し て 移動 を 
終了 し た と き に 発生 し ます 。 


邊 IKEvent ク ラス の 主 な イベ ント (定数 ) と イベ ント 内 容 
DISTANCE_LIMIT IKMoverdistanceLimit で 指定 され た 距離 を 超え た 場合 に 発生 し ます 
IKMoveriterationLimit で 指定 され た 繰り 返し 回 数 を 超え た 場合 に 発生 し ます 
IKMover の 反復 処理 の 各 ス テッ プ で 発生 し ます 。 
IKMovertimeLimit で 指定 され た 距離 を 超え た 場合 に 発生 し ます 
















ITERATION_LIMIT 









SINGLE_STEP 

















TIME_LIMIT 








特 IKEvent ク ラス の 主 な プロ パティ 概要 


ジョ イン ト の 元 の 位置 か ら の | distance ジョ イン ト の 元 の 位置 か ら の 距離 (ビク セル 上 単 
距離 位 ) を 表し ます 。 


IK 移 動 実行 の 繰り 返し 回数 1terationcoun1 IK 移 動 実 行 の 繰り 返し 回 数 を 表し ます 。 











イベ ント に 関連 し た ジョ イン | joini | イベ ント に 関連 し た ジョ イン ト を 表し ます 。 
ト | | 








前 回 の IK イ ベン ト か ら の 経過 | time | 前 回 の IK イ ベン ト 送 出 か ら の 経過 時 間 ( ミ リ 秒 
時 間 > 単位 ) を 表し ます 。 














5ARTETLE し ロロ トー 症 mm ドド 


IK イベ ント を 使用 する IKSampieC.fla 
1DOY 上 上] 1K.*: 
Var a エ mm : [KATma ヒ UTG : 
Var arqde ヒ BoOne : TKBOne : 
Var tarqdetJo1nrnt : TKJoint : 
Var 1Km : TKMOVer : 
Funotion ni ( ) :vo1d { 
arm = TKManager .detArmatureAt( 0 ): 
/ / 名 前 で TKBone オ ブ ジ ェクト を 取得 


ardetBOoOne = arm.qetBoneByName ( "tarqgetBone" ): 


7-8-3 


IKEvent を 使う 
// エ KBone オ ブ ジ ェクト の ルー ト と 逆 側 の TKJo1int オ ブ ジ ェクト を 取得 
tardet 上 Jont = tarqetBone . 上 a11JO1nt : 
/ /targetJoint の 現在 の 位置 を 基点 と する TKMover オ ブ ジ ェクト を 作成 
tkm = new TKMover ( targetJon , tarqdetJoint .poO811on )』 
/ ERKMOVSr ぶ オプ ジェ タ ト に 相本 の 制 隊 フロ ルディ 差 設 症 一 ーーーーー イ ーーmーーー ヤ ーー ーー ーー この の 
sao)Itibt 間 0 が ト - す oeooawaeeawanstctzegaytpevaskoceaeaoscsseseaseuaeae 
/ / TKMover オ ブ ジ ェクト に 距離 の 制限 値 を 超え た 場合 停止 する プロ パテ ィ を 設定 
学 半 k、 よ よ (N も も VO よね も きま の の 、 直 も お 0 まそ 
/ / TKMover オ ブ ジ ェクト が 距離 の 制限 値 を 超え た 場合 ひ の イ ベン トル ンド ラ を 設定 
1km .addEventListener (TKEvent .DTSTANCE LIMTT, 11mitExceeded ) : 一 一 ④ 


/ /「 伸 ば す 」 ボ タン と 「 曲 げ る ] ポ ボタ ン の イベ ント リス ナー 登録 
b1 btn.addEventListener( MouseEvernt .CLTCK, moveForward ): 
b2 btn .addEventL1gtener( MOuseEvent .CLTCK, moveBaCk ): 
8 
/ /「 伸 ば す 」 ア クシ ョ ン 
Function moveForward (event : MouseEvent ) :vo1d { 
Var pt : Poin = tarqetJoOin .DO81 キ 1On: 
// ジ ョ イン ト の 位置 を x : 10、y: 10 移 動 さ せる 
1km.moveTo( new Po1nt 上 ( p モ 上 .x + 10, pE 上 .Y マ + 10 ) ): 
) 
/ /「 曲 げ る ] ア クシ ョ ン 
function moveBaok (event : MouseEvent ) :Yo1d { 
Var Dt : Poin = tardet 上 on .DO81 キ 1On : 
// ジ ョ イン ト の 位置 を x : -10、: - 10 移 動 で せる 
1km.moveTo( new Point( pt.x - 10, pt.yY - 10 ) ): 
) 
/ / TKMover の イベ ント ハル ンド ラ 
Function 11mitExoeeded (event : TKEvent ) :Yo1d 1 
trace ( "TKEvent が 発生 し まし た 。" + event .type ): 
trace ( "対象 の ジョ イン ト :" + event .]oint .name ): 
trace ("distance : " + event.distanoe ): ⑤ 
traoe ("1terat1onCount :" + event .1terat1onCount ): 
YaCe(" ぎ mn" ): 
) 
1n1 ( ) : 


StOD ( ) 
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7-8 
IK( イ ン バ パ バース ・ キ ネ マ ティ ックス ) 


工大 区 鐘 の サン プル コー ド に IKMover に 対す る 距離 の 制限 を 行い 、 イ ベン ト を 発生 させ て い 
ます 。① い か ら が その 設定 で す 。 そ の 中 の ⑧ で distanceLimit プ ロバ ティ を 設定 し て お り 、 こ こ 
で IKMover オ ブ ジ ェクト に 距離 の 制限 を か け ま す 。 距離 の 制限 を 超え た と き に 移動 を 停止 する 
た め に は 、③ の よう に IimitByDistance プ ロ パ ティ を true に する 必要 が あり ます 。 距離 の 制限 
値 を 超え た 場合 、distanceLimit イ ベン ト が 発生 する の で 、④ で ハン ドラ の 登録 を 行っ て いま す 。 
この と き 、 イ ベン ト オ ブ ジェ クト は IKEvent に な り ま す 。⑤ の ハン ドラ 関数 で その プロ パテ ィ 
を 参照 し て いま す 。 


品 asl5 9 
| ファ イル (f) 編集 仙 表示 W 挿入 修正 テキ スト コマ ンド ( 凡 御 (0) デバ ッ グ (D) ウィ > 
呈 > ッ 1 名 多 


ァ - 





ター ゲッ ト の ジョ イン ト 名 称 


し 


イン スタ ンス : シン ボル 3 
* メ 信 置 し け サイズ 


ゃ マ z カラ うこ 効果 
2 タル な し し |y| 








NOS NNE ノ コン で を 表 ッ 


実行 結果 (トレ ー ス 出力 : 「 伸 ば す ] ボタ ン を 3 回 押し た 場合 ) 
TKEvent が 発生 し まし た 。distanoeLi1m1 上 
対象 の ジョ イン ト :1kNode こぶ し 
distamce : 0.19317374356947167 


1terationCount : 6 


TKEvent が 発生 し まし た 。distanoceLi1m1i 
対象 の ジョ イン ト :1kNode こぶ し 
distancCe : 0.1694199953439017 


1terat 上 1onCount : 6 


TKEvent が 発生 し まし た 。distance11m1t 
対象 の ジョ イン ト :ikNode こぶ し 
distance : 0.14397025475594957 


1t 上 era 上 1onCount : 6 


7 - 9 ジオ メト リ に よる 2 次 元 操作 
2 次 元 の 平面 座標 で の オブ ジェ クト 


ネル sl ux メー シル レア 


2 次 元 の 平面 座標 系 で 表示 オブ ジェ クト を 移動 、 回 転 し た り 、 距 離 を 測定 する な どの 操作 を 
サポ ー ト する クラ ス は ジオ メト リ (geometry: 畿 何 学 ) クラ ス と し て 、flash.geom パ ッ ケ ー ジ 
に 用 意 さ れ て いま す 。 そ の クラ ス 群 は 直接 オブ ジェ クト へ の 操作 を 実行 する の で は な く 、 座 標 
目 体 を 表し た り 、 距 離 を 算出 し た り 、 移 動 に 伴う 座標 の 変換 (変更) を 行う と いう よう な 補助 的 
な 役割 を 提供 し ます 。2 次 元 平面 で の 座標 位置 は H、 ス テー ジ の 左上 を 基準 (xy) = (0.0) と し て 、 
x の 値 が 増加 する と 右 方 向 、y の 値 が 増加 する と 下方 向 に 移動 し ます 。ActionScript3.0 に 用 意 
され て いる ジオ メト リ 関 連 の クラ ス に は 下 表 の も の が あり ます 。 も っ と も 基本 と な る Point ク 
ラス は 平面 上 の 座標 を 表し 、 座 標 に 関す る 演算 メソ ッ ド を 提供 し ます 。 





暫 2 次 元 関連 機能 を サポ ー ト する ActionScript3.0 クラ ス 


flash.geom Xx、y か ら な る 2 次 元 座 標 の 位置 を 表し ます 。 


左上 の 座標 と 幅 、 高 さ を 持 つ 四角 形 の 領域 を 表し ます 。 


Mat エ ュ x Z 次 元 平面 で 回 転 、 拡 大 / 縮 小 、 平 行 移 動 な どの 操作 を 行う た め の 
座標 変換 を 行う メソ ッ ド を 提供 し ます 。 


表示 オブ ジェ クト が Matrix イ ンス タン ス に アク セス する 方 法 を 提 
恩 Point ク ラス の 主 な プロ パテ ィ 概 要 


供し ます 。3DMatrix オ ブ ジ ェクト や colorTransform へ の アク セ 
ス も 提供 し ます 。 
オブ ジェ クト の 水平 / 垂 | : 
直 座 標 取得 / 設 定 する ) 
(0. 0) か ら の 直線 距離 を 求 | ] 
め る 


物 Point ク ラス の 主 な メソ ッ ド 概要 


オブジェ クト の コピ ビー | c1one 
を 作成 する 


別 の Point オ ブ ジ ェ ク 
ト と の 距離 を 求め る 
































プロ パテ ィ の 概要 


Point オ ブ ジ ェクト が 持つ 水平 / 垂 直 座 標 を 表し ます 。 


現在 の 座標 の (0. 0) か ら の 距離 を 算出 し ます 。 
































メソ ゾ ッ ド の 概要 


現在 の Point オ ブ プ ジ ェ クト の コピ ー を 作成 し ま 
ま 。 


パラ メー タ で 渡し た 2 つの Point オ ブ ジ ェクト 
の 距離 を 算出 し ます 。 こ れ は static メ ソ ッ ド で 
す 。 






pt 1 : Point , 
pt2 : Point ) : Number 
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PART 
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ag 。 
ジオ メト リ に よる 2 次 元 操作 


名 Point ク ラス の 主 な メソ ッ ド 概要 (続き ) 


メソ ッ ド の 概要 


現在 の オブ ジェ クト が パラ メー タ で 渡さ れ た 
Point オ ブ ジ ェクト と 等 し い 座標 か を 調べ ます 。 























別 の Point オ ブ ジ ェ ク 
ト と 等 し いか 調べ る 


equals( 
toCompare : Po1r ) : 
Bool」ean 









パラ メー タ で 指定 し た 2 つの Point オ ブ ジ ェ ク 
ト の 間 に 位 置 す る 座標 を 返し ます 。f は 補間 レ 
ベル で 、]1 な ら pt1、0 な ら pt2 を 返し ます 。 こ 
れ は static メ ソ ッ ド で す 。 






2 つ の Point オ ブ ジ ェ 
クト の 間 に 位置 する 座 
標 を 求め る 


1nterpolae ( 
の も 1 : PO1mE , p2: 

Point , f :NumDer) : 
PO1n ヒ 







中 stamce- 9 
中 間 点 =497.121) 


B 
(497.12-』 







distamce: ④⑪2 
distamce: 328 中 間 点 =(375.277 の 
中 間 点 =(158.303) 







作 
(375.277) 






音 
(158,.303) 


呈 AMIP ピ LE ロロ ロ ヒ 


Point ク ラス メソ ッ ド の 使用 GeomSampleAfla 


1mpor Fl]ash.d1splay . SDr1Ee 
/ / 基 点 と する Point 上 オブ ジェ クト 
補 き ま SCaE も PO まれ も: PO4nE = new BonE(10。 10) 一 一 ーーーーーーーーーーーーーーー 
/ / マ ウス ダウ ン の イベ ント ハン ドラ 
this . stage . addEventL1 st 上 ener (MouseEvent .MOUSE DOWN, showPort ): 
Function showPoint (event :MouseEven ) :Yo1d { 
Var pt :Point = new Poin ( event . staqeX, event .staqeY ): 
// ラ イブ ラリ の myjPoin モ 上 クラス の イン スタ ンス を 作成 し て 配置 
var ob] :Disp1ayOb]ect = his.addChi1d( new myPoint() ): 
Ob XX w つも: 玩 。 ② 
ob] .Y = pt.Y: 
myPoint (ob] ) . showPoint( his ag Sprite, gtartPoin  ): 
/ / 基点 と の 中 間 点 を 算出 


ナッ ザー] 
2 次 元 の 平面 座標 で の オブ ジェ クト 操作 を サポ ー ト する クラ ス 


Var DDt:Poin = Point .1nterpo1ate( startPoint , pt, 0.5 ) : ニーーーーー③ 
Var f:TextF1e1qd = new TextFie1d ( ) : 


tf .mu]lt1]1nme = True : 


/ / 基 点 と の 距離 を 算出 
tfF .text = "digtanCe: " + nt( Point .distanoe ( startPoint, pt ) ) 
+ 『 党 n 中 間 京 =(" + pt.x + "の + pE.Y + ")『: 


も を 。 交 = DD も. 
も 。W = DDL.: 
addCh11d( tf ): 
) 
/ / 基点 を 設定 


Function init () :vo1d { 





th18 .DO1n 上 1 .xX = 8 ヒ ar 上 Point . 交 : 
th1g .Do1nt ] . = garPoint .Y: 


this .poin1 . showPoint ( nu11, nu11 ): 


) 


3 も ( ) 。 


Point ク ラス を 使用 し て 2 つの 座標 の 中 間 点 と 距離 を 算出 する サン プル で す 。 基点 と する 座標 
(10,10) は ① で Point オ ブ ジ ェクト を 作成 し て いま す 。 こ の Point オ ブ ジ ェクト と 、 マ ウス で ク 
リッ ク し て 配置 され る ムー ビー クリ ッ プ (ライ ブラ リ 内 の myPoint) と の 中 間 点 と 距離 を テキ ス 
ト フ ィ ー ル ド で 表示 し ます 。 マ ウス を クリ ッ ク し た と き の ム ー ビ ー ク リッ プ の 配置 は 、② で 
行っ て いま す 。 新しい Point と 基点 と の 中 間 点 は ③、 距 離 (④ で Point ク ラス の static メ ソ ッ ド を 
_ 呼び 出し て 算出 し て いま す 。 


ライ ブラ リ 内 の ムー ビー クリ ッ プ (myPoint) 
Var 8tarPoint : Point = new Point () : 
/ / 目 分 の 座標 を 表示 し て 基点 か ら 線 を 引く 関数 
Funct1on ShowPoint ( sprite:Sprite, pt:Point ) :vo1d { 
DO1 も X 上 も ext = “(m+ イキ ロナ マエ ")9: 
1f ( gprite == nu11] ) reEurn : 
8pr1te .qraphios .11neStyle( 1, OxDDDDDD ): 
8pr1te .qraphios .moveTo( pt.x, pt.y ): 


8pr1te .draphics.11ineTo( xx, y ) : 


マウ ス で クリ ッ ク し た 場所 に 点 と 座標 を 描く た め の ム ー ビ ー ク リッ プ で す 。 わ か りや すい よ 
うに 基点 か ら 線 を 引く よう に し て いま す 。 
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Rectangle クラ ス を 使う 





PART Rectangle ク ラス は 平面 上 の 知 形 (四角形) を 表し 、 関 連 す る メソ ッ ド を 提供 し ます 。2 次 元 の 
平面 座標 系 で は ステ ー ジ と 同様 の 知 形 領域 を 扱う 場合 が 多く 、 そ の 座標 と サイ ズ を 表す た め に 
Rectangle ク ラス オブ ジェ クト が 使用 され ます 。 オ ブ ジ ェクト に する こと に より 、 乱 形 を 表す 
デー タ を パラ メー タ と し て 使用 し た り 、 ク ラス が 提供 する メソ ッ ド を 使用 する こと が で きま す 。 


乱 Rectangle クラ ス の 主 な プロ バテ ィ 概 要 
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オブ ジェ クト の コピ ー を 
作成 する 


ある 座標 が 息 形 内 に ある 
か 調べ る 


別 の Rectangle オ ブ ジ ェ 
クト が 自 オ ブ ジ ェクト 内 
に ある か 調べ る 


別 の Rectangle オ ブ ジ ェ 
クト と 自 オ ブ ジ ェクト 
の どちら も 含む 知 形 を 
表す Rectangle オ ブ ジ ェ 
クト を 作成 する 








て ]] 選 


: RecCtand1e 


* 〇 jn ロ 上 1m ロ 8 PO1 ュ 1 
(poO1nt : Po1n セ ヒ 
: Boo」ean 


(て ec : ReCtand1e) 
: Boolean 


(toUn1on : Rectand1e 
: RecCtand1e 


それ ぞ れ の プロ パテ ィ は x 座 標 、 ま た は y 
座標 の 値 を 表し ます 。 topLeft と bottom 
Right は x、y 座 標 を 持つ Point オ ブ ジ ェ 
クト で す 。 


topLeft 


left 


現在 の Rectangle オ ブ ジ ェクト と x、y、width、 
お よび height の 各 プ ロ パ ティ の 値 が 等 し い 新 
し い Rectangle オ ブ ジ ェクト を 返し ます 。 


point で 指定 され た 座標 が 現在 の オブ ジェ クト 
知 形 領域 内 に ある か どう か を 判別 し ます 。 





rect で 指定 され た Rectangle オ ブ ジ ェクト が 
現在 の オブ ジェ クト 知 形 領域 内 に ある か どう 
か を 判別 し ます 。 


toUnion で 指定 され た Rectangle オ ブ ジ ェ ク 
ト と 現在 の オブ ジェ クト を 加算 し た Rectan 
gle オ ブ ジ ェクト を 返し ます 。 





プー サー タメ 
Rectangle クラ ス を 使う 


OCSKOASNSASYSN . ぶ 
9 


ファ イル (E) 表示 V) 末 科 GO 


=% 上 明 画 ヨコ 蘭 -------------ー-ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 








テバ ッ ク () 





























※(①<⑤ の 番号 は 実行 時 に は 表示 され ませ ん 。 


に 2 コ 間 ヨ 間 mmlg】 ヨ 織 - - -- ------------------------------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


Rectangle クラ ス を 拡張 する クラ ス の 使用 GeomSampleB.la 


/ / カ スタ ムク ラス の イン ポー ト 
1mport myPackage .MyRectanqd1e : 


1mport flash .qgeom . Rectanqg1e: 


/ / 開 始点 と 終了 点 を 示す Point オ ブ ジ ェクト 変数 
Var で や キ 1 : Po1nt , p キ 2 : Bon : 


// マ ウス の イベ ント ハン ドラ 登録 
this . gtage . addEventListener (MouseEvent .MOUSE DOWN, setStar) : 
this . stage . addEventTLi stener (MouseEvent .MOUSE UP, setEmnd) : 


// マ ウス ダウ ン の 座標 を 開始 点 と し て Po1int オ ブ ジ ェクト を 作成 


Function setStart (event : MouseEvent ) :Yo1d { 


pt1 = new Pon ( event . staqgeX, event .staqeY ): 了 
) 
/ / マ ウス アッ プ の 座標 を 終了 点 と し て Point オ ブ ジ ェクト を 作成 
Function setEnd (event : MouseEvent ) :Yo1d 1 

ュ 下 ( p ヒ 1 == GU11 ) reuYn: 

pt2 = new Po1n ( event . stageX, event . staqgeY ): ② 


1f ( pt2.equals( pt1 ) ) return: 
/ /Rerctang1e を 拡張 し た カス タム クラ ス の オブ ジェ クト を 作成 
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ae 
ジオ メト リ に よる 2 次 元 操作 


Ya reo :MyRectangle = new MyRectangle( pt1, pt2 ): 


// シ ェ イ プ ブ を 描画 


PART rec .drawMe ( this, 1, OxFFO0000 ): 


rectg .DuSh( reoct ): 


@ 


/ / 作成 し た 四角 形 を 格納 する 配列 
Ya GoC8 : ム エエ ay = mew Array () : 
b1 btn.addEventListener( MouseEvent .CLTCK, checkRect8 ): 
Function oheckReocts (e :MouseEven ) :vo1d { 
if ( reotsg.1ength < 2 ) { 
trace( 『 比 較 す る 四角 形 が あめ あり ませ ん 。" ): 


どら GU11 
7 
机 和 まえ 


for ( var 1:int = 1 : 1 < rectg.1ength : 1++ ) { 
//containRect ( ) メソ ッ ド で 2 番目 以降 の 四角 形 が 1 番目 の 四角 形 に 含ま れる か 調べ ます 
if ( Rectangle ( rectg[0] ) .containsReot ( Rectangle( rectg[1] ) ) 


まま 
trace( ( 1 + 1 ) + 『 番 目 の 四 角形 が 1 番目 の 四角 形 の 内 側 に あり ます 。" ): 


この サン プル で は 、Rectangle ク ラス を 拡張 する カス タム クラ ス (MyRectangle) を 作成 し 
て 使用 し ます 。 プ ログ ラム の 処理 と し て は 、 マ ウス ダウ ン で 四角 形 の 左上 座標 、 ド ラッ グ し て 
マウ ス ア ッ プ し た 座標 を 四角 形 の 右 下 と な る よう に MyRectangle オ ブ ジ ェクト を 作成 し て ス 
テー ジ 上 に 描画 し ます 。 マ ウス ダウ ン の 処理 は ① マ ウス アッ プ の 処理 と MyRectangle オ ブ 
ジェ クト の 作成 は ② で 行っ て いま す 。③⑬ 以 降 は オプ ショ ン の 処理 で 、 最 初 に 描い た 四角 形 の 中 
に 2 番目 以降 の も の が 含ま れる か を containsRect() メ ソ ッ ド で 調べ る 処理 を 行っ て いま す 。 


myPackage.MyRectangle.as 


package myPackage{ 
1mport Flagh.d1splay . ShaDp6e : 
1mport fl]agh .geom . Rectand1e : 
1mpor 上 Flagh .qdeom . Po : 


1mport Fl]ash.display .D1isplayOb]ectContainer : 
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7ー9-2 
Rectangle クラ ス を 使う 


1mport Flash.events .MouseEVvent : 


pub1io cl]ass MyRectanqgle extends Rectangle { 

Yar 8:ShaDpe : 
/ / コ ンス トラ クタ (pt1 : 左上 座標 、pt2 : 石 下 座標 ) 
pub1ioc function MyRectang1e ( pt1 :Point , pt2 : Point) {1 
//Rectang1e ク ラス の コン スト ラク タ に パラ メー タ を 渡し て オブ ジェ クト を 構築 ④ 
SMDS ア ( DE1.X。 DCL.V。 (BE2.X - po 区) , (PE2、\ = DE は .Y) )) 
) 
/ / 目 分 が 持っ て いる Rectang1e オ ブ ジ ェクト の 息 形 を 描画 する 関数 ⑤ 
pub11c funot1on drawMe ( stq:D1isplayOb]ectContainer, th1okKne88 : 
Number, co1or:uint ) :Shape { 

= new Shape ( ) : 

-draphics .]1neStyle( thiockness, Co1or ) 


.draphics .moveTo( 0, 0 ): 


・draphics .11neTo( thigs.w1dth, this.height ): 


了 
8 
8 
8 .draphics .11neTo( this.w1dth, 0 ): 
8 
8 .draph1cCs .11neTo( 0, this.height ): 
8 .draphics.]1ineTo( 0, 0 ): 
stg.addChi1d( g ): 

8 .X = 七 h38,X: 

8 .Y = hi18.Y: 


GUTT 8: 


Rectangle ク ラス を 拡張 する MyRectangle ク ラス で す 。MyRectangle ク ラス で は 、(④ の コ 
ンス トラ クタ で 征 形 の 左上 と 右 下 の 座標 を 示す 2 つの Point オ ブ ジ ェクト を 受け 取り 、 ス ー パ ー 
クラ ス の Rectangle コ ンス トラ クタ に 渡し ます 。⑤ の drawMe() メ ソ ッ ド で は 、 DisplayObjec 
tContainer オ ブ ジ ェクト を 受け 取り 、 そ こ に 自分 が 持つ Rectangle デ ー タ に 基づい て シェ イ 
プ を 描画 し ます 。 


ぁ 実行 結果 (トレ ー ス 出力 : 「 チ ェ ッ ク ] ボタ ン を 押し た 場合 ) 


2 番目 の 四角 形 が 1 番目 の 四角 形 の 内 側 に あり ます 。 
3 番目 の 四角 形 が 1 番目 の 四角 形 の 内 側 に あり ます 。 
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Matrix クラ ス で 移動 、 回 転 、 
拡大 / 縮小 を 行う 


PART 表示 オブ ジェ クト の x、y、rotation、witdh、height、scaleX、scaleY プ ロバ ティ な ど を 
直接 変更 する こと で 移動 や サイ ズ 変 更 な どの 処理 を 行え ます が 、Matrix ク ラス を 使用 する と メ 
ソ ッ ド を 使用 し た り 、 複 数 の 変更 を まとめ て 設定 し て か ら オ ブ ジ ェクト に 適用 する こと が で き 
ます 。 表 示 オ ブ ジ ェクト に Matrix オ ブ ジ ェクト を 適用 する に は 、tramsform プ ロ パ ティ で 取 
得 で きる Transform オ ブ ジ ェクト の matrix プ ロ パ ティ に 作成 し た Matrix オ ブ ジ ェクト を 設定 
し ます 。Matrix ク ラス で は 、 プ ロ パ ティ の 概要 に ある よう な 行列 に 変換 の た め の 数 値 を 格納 し 
ます 。 こ の 行列 は 変換 マト リッ クス と 呼ば れ 、 行 列 内 の プロ パティ は それ ぞ れ 目的 が 決ま っ て 
いる た め 、 直 接 編集 する こと も 可能 で す 。Matrix ク ラス を 使用 し て 表示 オブ ジェ クト の 変更 を 
行う 一 般 的 な 手順 は 次 の よう に な り ま す 。 





息 Matrix クラ ス で 表示 オブ ジェ クト の 座標 変換 を 行う 手順 


対象 の オブ ジェ クト の trasform プ ロ パ ティ で Transform オ ブ ジ ェクト | Transform( 参 照 の み ) 
を 取得 し 、 そ の オブ ジェ クト の matrix プロ パテ ィ で 得 ら れる Matrix オ | Matrix 
プ ブ ジ ェクト を 変数 に 格納 する 


格納 し た Matrix オ ブ ジ ェクト に 目的 の 変換 を 適用 する 


変換 を 適用 し た Matrix オ ブ ジ ェクト を 再び 対象 オブ ジェ クト の 
transform.matrix プロ パテ ィ に 設定 する 








変換 マト リッ クス 内 で 目的 の 操作 
| を 行う た め の パ ラメ ー タ で す 。 





x 軸 方 向 の 回 転 、 傾 織 の パラ メー タ を 設定 


y 軸 方 向 の 回 転 、 傾 斜 の パラ メー タ を 設定 
「 (0 と 1 の 数 値 が 書か れ た 場所 は 、 常に 
その 値 で ある こと を 表し ます ) 








x 軸 方 向 の 移動 距離 を 設定 


y 軸 方 向 の 移動 距離 を 設定 
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ナー ツー 過 
Matrix クラ ス で 移動 、 回 転 、 拡 大 / 縮 小 を 行う 


和 Matrix ク ラス の 主 な メソ ッ ド 概要 


オプ ジェ クタ クト の コピ ー を 作 
成す る 


メソ ッ ド の 概要 


現在 の Matrix オ ブ ジ ェクト と 
同じ 変換 マト リッ クス を 持つ 
新しい Rectangle オ ブ ジ ェ ク 
ト を 返し ます 。 


回 転 、 拡 大 / 縮 小 、 平 行 移 動 
に 関す る 変換 を 引数 で 指定 す 
る と 、 オ ブ ジ ェクト 内 の 変換 
マト リッ クス に 適用 され ます 。 












Clone ( ) 
:Rectand1e 





























回 転 、 拡大 / 縮 小 、 平 行 移動 
の 変換 を まとめ て 設定 する 


CreateBOox ( 
8CaleX : NumDber, goaleY: 
NumDer , rotation : NumDer = 0, 
上 x:Number = 0, 

ty:Number = 0O 

) :YO1d 






























CreateGradientBox (w1dth : 
Numlbber , 

he1qght : Number , 
rotat1on : Number = 0, 

x : NumDer=0 , 

上 y : NumDer=0 

) :Yo1d 


適用 する グラ デー ショ ンス 
タイ ル を 作成 する 


Graphics ク ラス の beginGra 
dientFil(0 メ ソ ッ ド お よび line 
GradientStyle() メ ソ ッ ド で 使 
用 する 特定 の スタ イル を 作成 
し ます 。 




















回 転 変換 を 適用 する オプ ジェ クト の 変換 マト リッ 


クス に 回 転 変換 を 適用 し ます 。 


rotate ( 
and1e : NumDer 
) : ゞ Oo1d 













Cal1e ( 
8X : NumDer , 8SY :NUumDer 
) :YO1d 







拡大 / 縮 小 変換 を 適用 する オブ ジェ クト の 変換 マト リッ 
クス に 行列 に 拡大 / 縮 小 を 適 


用 し ます 。 


オブ ジェ クト の 変換 マト リッ 
クス に 平行 移動 を 適用 し ます 。 















平行 移動 を 適用 する translate ( 
dx : NumDber , dy :NumDer 


) :Vo1d 

























現在 の マト リッ クス を ある 
Point オ ブ ジ ェクト に 適用 
し た 結果 を 得る 


trangFormPonin ( 
PO1nt : Po1n 七 
) : Po1n 七 


point で 与え られ る オブ ジェ 
クト に 現在 の 変換 を 適用 し て 
新しい Point オ ブ プ ジ ェ クト を 
返し ます 。 








急 Matrix クラ ス の 移動 、 回 転 、 拡 大 / 縮 小 に 関す る メソ ッ ド 詳細 


roate ( angle で 指定 し た 角度 で 表示 オブ ジェ クト を 回 転 さ せま す 。 回転 は 親 コ 
and1e : NumDer ン テ ナ の 基準 点 を 中 心 と する 回 転 に な り ま す 。 角度 (angle) は ラジ アン 
) :Vo1d 表記 で ある た め 、0 て +360" か ら 次 の よう な 計算 で 変換 し て 渡す 必要 
が あり ます 。 

ラジ アン = 2* Math.PI * ( (0 て ェ 360 の 角度 ) / 360 ): 

90 度 の 回 転 を 加え る 場合 、 次 の よう な 計算 を し ます 。 

angle = 2 * Math.PI * ( 90 / 360 ) 


sx.Sy で それ ぞ れ 水平 方 向 、 垂 直方 向 の 拡大 、 縮 小 を 行い ます 。 変換 は 
ロー カル 座標 系 の 拡大 / 縮 小 と な り 、 表 示 オ ブ ジ ェクト が 基準 点 (0.0) か 
ら 離 れ て いる 場合 、x、y 座 標 も 変化 し ます 。sx、sy は 乗数 で 指定 する 
の で 、1.5 を 指定 する と 1.5 倍 の 拡大 に な り ま す 。 























Scale ( 
8X : NumDer , 8Sy : NumDer 
) :Vo1d 
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PART 
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ナー ツ 
ジオ メト リ に よる 2 次 元 操作 


筆 Matrix クラ ス の 移動 、 回 転 、 拡 大 / 編 小 に 関す る メソ ッ ド 詳細 (つづ き ) 


trangs1ate ( dx、dy で 指定 し た ピク セル 分 、 オ ブ ジ ェクト を 現在 の 位置 か ら 水平 、 
dx : Number, dy:Number | 垂直 移動 し ます 。 
) : ゞ Oo1d 


















っ EO「TI ら < | 


ファ イル (F) 表示 (y) 渦 御 ( 〇 デバ ッ グ (D) 





マウ ス を ドラ ッ グ する と 息 形 を 押 く こ と が で きま す 。 


1 画 コ 首 mmp】 ヨ 蘭 0 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


Matrix オブ ジェ クト に よる 回 転 、 拡 大 / 縮 小 、 移 動 を 行 GeomSampieC.la 


1mport fF]agh .qdeom . Ma エ 1x : 
// カ スタ ムク ラス の イン ポー ト 
1mport myPaockage . Cu8tomEVen : 





いり! 


1mport myPaockage .MyRectang1e2 : 

1mport fFlash .qdeom .Rectand1e: 

/ / 開 始点 と 終了 点 を 示す Point オ ブ ジ ェクト 変数 

Var pt1 : Po1nt , p2 : Pon : 

/ /Matr1x を 適用 する 表示 オブ ジェ クト 

Var ShaDp : ShaDe : 

// マ ウス の イベ ント バン ドラ 登録 

this . stage . addEventListener (MouseEvent .MOUSE DOWN, setStar) : 
this . staqe . addEventLi1i stener (MouseEvent .MOUSE UP, setEnd) : 
thisg .addEventListener ( "matrixData" , detMa ヒ エ + ュ 文 ) : 


Funotion qetMatrix (e :CustomEvent ) :void {1 


ナー テー 
Matrix クラ ス で 移動 、 回 転 、 拡 大 / 縮 小 を 行 


U) 5 


1f ( ghap == nu11] ) reurn : 

/ / 現在 の Matr1x オ ブ ジ ェクト を 取得 し て 座標 変換 を 行う 

Var mtx:Matr1x = ghap .tran8fForm . ma ヒエ ュ X : 

// 拡 大 / 縮 小 変換 

if ( Number(e.data.scaleX) != 1 | | Number(e.data.scaleY) != 1 ) 
mtx.Scale( Number(e.data .scaleX) , Number(e.data.scaleY) ): 

/ / 回 転 変換 

1f ( Number(e.data .rotat1on) != 0O ) 
mtx.rotate( Numper(e.data .rotation) ): 

/ / 平行 移動 

if ( Number(e.data.tx) != 0O | | Number(e.data.ty) != 0 ) 
mtx.translate( Number(e.data .tx) , Number(e.data .t 上 Y) ) 

/ /Ma ヒ 上 r ュ x オ ブ ジ ェクト を 適用 


ghap .tran8fForm . ma ヒエ 1x = mtx: 





/ / マ ウス ダウ ン の 座標 を 開始 点 と し て Point 上 オブ ジェ クト を 作成 


Funotion setStart (event : MouseEvent ) :Yo1d {1 
/ / パ ラメ ー タ 設定 用 の パネ ル 上 な ら 描 画 を 行わ な い 
1f ( event.Earqget .name == "pane] mC" ) return: 
pt1 = new Po1n( event . staqeX, eVvent .staqdeY ): 
) 
/ / マ ウス アッ プ の 座標 を 終了 点 と し て Poimt 上 オブジェ クト を 作成 
function setEnd (event :MouseEvent ) :Yo1d 1 
ュ f ( や し 1 =a Hu11 ) PeLUYD: 
pt2 = new Porn ( evenrnt . staqeX, event .gtaqeY ): 
1f ( pt2.equals( pt1 ) ) return: 
/ /Rerctangle を 拡張 し た カス タム クラ ス の オブ ジェ クト を 作成 
Yar rect :MyRectangle2 = new MyRectangle2( pt1, pt2 ): 
// シ ェ イ ブ ゴブ を 描画 
Shap = rect.fF1i11Me( this, 1, Ox000000, OxFF4400 ): 
// イ ベン トリ スナ ー 登 録 の 削除 
this . stage . removeEventL1 st 上 ener (MouseEvent .MOUSE DOWN, setStar)) : 
thisg . stage . remOVeEventL1stener (MouseEvent .MOUSE UP, setEnd) : 


画面 右上 の 変換 バラ メー タ を 設定 する パネ ル は 、 ム ー ビ ー ク リッ プ に な っ て いま す 。 下記 の 
ソー ス を ご で ご覧 くだ さい 。 こ の ソー ス で は 、 バ ネル か ら 送 られ る バラ メー タ を ① い の コー ド で ステ 
ー ジ 上 に 作成 され た Shape オ ブ ジ ェクト に 手順 の と お り 適 用 し ます 。② 以 降 は マウ ス で Shape 


オブ ジェ クト を 描画 する た め の 手 順 で 、Matrix と は 関連 は あり ませ ん 。 271 
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は 。 
ジオ メト リ に よる 2 次 元 操作 


ライ ブラ リ 内 の ムー ビー クリ ッ プ (matrixPanel) 
1mpor Flash .qeom . Ma ヒエ ュ 1xX : 
1mpor 上 myPackaqe .Cu8tomEVenrt : 
PART this .apply btn . addEventListener (MouseEvent .CLTCK, cl1ickHand1ler ): 

Funotion cl1iokHand1er (event : MouseEven ) :vo1d { 
var OoD] :Ob]ect = new Ob]ect () : 
ob] . scaleX = this.scaleX ng .Va1uG : 
ob] . scaleY = this.scaleY ng .Va1ue: 
ob] . rotation = 2* Math.PT * ( this.rotation ns.Value / 360 ): 
ob] .tx = his.tx ng8.Va1ue : 
ob] .ty = hg .ty n8.Va1Uu6: 
Ya @eV:CustomEven = new CustomEven ( "matr1xDaa") : 
eV .data = ObD]: 


SC お ね も も DAEGhEVettE ( @y ) テ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 信 


配置 され た NumericStepper オ ブ ジ ェクト の 入力 値 を カス タム イベ ント オブ ジェ クト に 格納 
し て ディ スバ パッ チ し ます 。 イ ベン ト タ イ プ は "matrixData" で す 。 メ イン タイ ムラ イン ソー ス 
の 3③ で この イベ ント を リス ン す る 設定 を 行っ て いま す 。 


myPackage.MyRectangle2.as 


package myPackage{ 

1mpor 上 fF]ash.display . ShaDe : 

1mpor 上 Flash .qeom .Rectanqg1e : 

1mpor ヒ 上 Flash .qeom . Po1n : 

1mporE Flash.displ1ay .DisplayOb]ectContainer : 

1mpor flash.events .MouseEvent : 

pub1ioc cl]ass MyRectangl1e2 extends Rectangle {1 
Var 8:Shape : 
// コ ンス トラ クタ (pt1 : 左上 座標 、pt2 : 右 下 座標 ) 
pub1ic funoction MyRectanqle2 ( pt1:Point, pt2 :Point) { 
//Rectang1e ク ラス の コン スト ラク タ に パラ メー タ を 渡し て オブ ジェ クト を 構築 
EGODGY( わり も 1 .X。 DE う 3 ) ぴ 。 (DC2 2 ・ や 人 も よ ,XX) , (BB も 3 ーー E ヒ 1、M) )) 
) 
/ / 自分 が 持っ て いる Rectang1e オ ブ ジ ェクト の 乱 形 を 描画 する 関数 
pub11C funot1on drawMe ( std:D1SplayOb]ectConta1ner, 上 1Ckne88 : 
Number, co1or:uint ) :Shape { 

8 = new Shape() : 


8 .draph1oCs . 1neStyle( thickness, Co1or ): 


7/2 


ナー ザー 
つう 


Matrix クラ ス で 移動 、 回 転 、 拡 大 / 編 小 を 行 


.draphics .moveTo( 0, 0 ): 

.draphiocs.11neTo( this.w1dth, 0 ): 

.draphics .11neTo( this.width, this.height ): 
.gdraphics .11neTo( 0, this.he1qght ): 


和志 。 生 . 界 


.draphics .11neTo( 0, 0 ): 
stg.addChi1d( sg ): 


8 XX = h18.XX: 
、 ツ = も 3 お, ザ : 
return 8: 


) 
/ / 自 分 が 持っ て いる Rectang1le オ ブ ジ ェクト の 知 形 を 描画 (Fi11 ) する 関数 
pub11ic funoction Fi11Me ( stg:D1splayOb]ectConta1ner , 
Numibper, co1or:uint, Fi11oo1or:uint ) :Shape { 

= new Shape () : 

.draphios .beq1nF1il1] ( fi]11co1or ): 

.draphics .11neStyle( tickmnes8, CoO1Or ): 


.draphics .moveTo( 0, 0 ): 


8 
8 
8 
に 
8 .qdraphrcs.1ineTo( this.width, 0 ): 
8 .draphics.1ineTo( his .w1dth, thigs.height ): 
8 .draphics.11neTo( 0, this.heiqht ): 

8g .graphics.1ineTo( 0, 0 ): 

stg.addChi1d( g ): 

8 、 炎 = も ね ま は 区 : 

8 .Y 
returTml 8: 


thig .: 





シェ イブ 描画 を 行う Rectangle を 拡張 し た クラ ス は 胃 張 党 久 [Rectangle ク ラス を 使う ] の サ 
ンプ ル で 使用 し た も の に 微細 な 追加 を 行っ た も の で す 。 fijllIMe()0 メ ソ ッ ド は beginFil(O0 メ ソ ッ 


ド を 呼び 出し て 知 形 内 部 に 塗り を 加え た の み で す 。 
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メーY 
ジオ メト リ に よる 2 次 元 操作 


遇 50 。 本. ScaleY= 5 
ォ ャ ーーーー 本 示 0。 ーーー デバック) 





ら Scale に 「otation=- 10 る ) 恩 加 し て 適用 


で a RON ES oo こさ ES て まく ーー 


ーー 


の 
oo 








ファ イル B 表示 の 計 人 (O デック 6 


暗 '5CHI を 科 了 際 に し rotation=- 10 に tx=10、 ty=-10 を 追加 し て 適用 


ラ ァイル (B 表 O 叶 和 (O アック 00 「 





7 -10 3D 
3D 関連 機能 を サポ ー ト する クラ ス 





Flash Player10 と デス クト ッ プ 実行 環境 で ある AIR の 1.5 以 降 の バー ジョ ン で は 、 す べ て の 表 
示 オ ブ ジ ェクト に z プ ロ パ ティ が あり ます 。 こ の z プ ロバ パテ ィ は 3D 座 標 系 で オブ ジェ クト の 配置 
に 奥行 き を を 与え た り 、 ユ ー ザ の 視点 か ら 距 離 を 持た せる た め に 使用 され ます 。 

表示 オブ ジェ クト を 3D 表 示す る に は 、z プ ロ パ ティ に 数 値 を 適用 し た り 、3D を サポ ー ト する 
回 転 、 拡 大 / 縮 小 プ ロ パ ティ を 使用 する こと で 3D ア ニメーション が 実現 で きま す 。3D 関 連 機 能 
を サポ ー ト する ActionScript3.0 ク ラス に は 、 下 記 の 表 の も の が あり ます 。 


符 3D 関 連 機能 を サポ ー ト する ActionScript3.0 ク ラス 


flash.display | DisplayObject ActionScript3.0 の 表示 オブ ジェ クト は z プ ロ パ ティ と 、 
3D 空 間 の 表示 オブ ジェ クト を 操作 する た め の 回 転 、 拡大 / 
縮小 プロ パテ ィ が あり ます 。 local3DToGlobal( ) メ ソ ッ ド 
は 3D ジ オメ トリ を 2D 平 面 に 投影 する 方 法 を 提供 し ます 。 


遠近 法 に よる 表示 オブ ジェ クト の 変形 を サポ ー ト し ます 。 
3D ジ オメ トリ を ZD 平面 ビュ ー に マッ ピン グ す る た め の バ 
ラメ ー タ が 制御 され ます 。 


PerspectiveProjection 
3D ジ オメ トリ の 回 転 、 拡 大 / 縮 小 、 平 行 移動 を 行う 複雑 な 


Matrix3D 
変換 を 簡単 に 行え る 方 法 を 提供 し ます 。 
Vector3D 3D ポ イン ト を 管理 する た め の デ ー タ 構造 を 表し ます 。 ベ 
クタ ー 数 式 も サポ ー ト し ます 。 


乱 DisplayObject ク ラス の 3D を サポ ー ト する プロ バテ ィ 詳 細 


プロ パテ ィ プロ パテ ィ の 詳細 


Xx、 y 、Z 座 標 に より 、 表 示 オ ブ ジ ェクト イン スタ ンス の 3D 空 間 内 の 位置 を 決定 し ま 
す 。 プ ロ パ ティ を 変化 させ る こと で 、3D 空 間 内 オブ ジェ クト を 移動 し ます 。 



























flash.geom 
































x 軸 、 y 軸 、z 軸 を 中 心 に 、 表 示 オ ブ ジ ェクト イン スタ ンス を 3D 空 間 で 回 転 し ます 。 
プロ パテ ィ の 値 は 回 転 角 度 を 表し ます 。 時 計 回 り に 回 転 さ せる 場合 は 0 ~~ 180、 反 
時 計 回 り に 回 転 さ せる 場合 は 0 て -180 の 値 を 指定 し ます 。 こ の 範囲 を 超え る 値 は 、 
360 を 加算 また は 減算 し て 、 範 囲 内 に 収まる 値 に な る よう に 調整 され ます 。 


表示 オブ ジェ クト イン スタ ンス の x、 y 、Z 方 向 の スケ ー ル (伸縮 ) を パー セン テー ジ で 
表し ます 。scaleZ を 変化 させ る こと で 、3D 空 間 内 の オブ ジェ クト の 奥行 き ス ケー ル 
を 変更 で きま す 。 













トコ ロロ 選 † 〇 て 


3D プ ロ パ ティ の 設定 に より 自動 生成 され る Matrix3D オ ブ ジ ェクト へ の 参照 を 含む 
Transform オ ブ ジ ェクト に アク セス で きま す 。Matrix3D オ ブ ジ ェクト は 3D 空 間 内 の 
表示 オブ ジェ クト の 表現 方 法 を 管理 し ます 。 


・Tran8fFOorm 





を 。 
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征 DisplayObject ク ラス の 3D を サポ ー ト する メソ ッ ド 詳細 


91oba1ToLoca13D( | point で 示さ れる ステ ー ジ 座標 (グロ ー バ ル 座 標 ) の 2 次 元 の ポイ ント を 、3 
Po1nt : Poin) : 次 元 の 表示 オブ ジェ クト の ロー カル 座標 内 の 3 次 元 の ポイ ント に 変換 し ます 。 
Vector3D 戻り 値 は その 3 次 元 ポ イン ト を 持つ Vector3D オ ブ ジ ェクト で す 。 


3 次 元 の 表示 オブ ジェ クト の ロー カル 座標 の 3 次 元 の ポイ ント を ステ ー ジ 座 
標 ( グ ロー バル 座標 ) の 2 次 元 の ポイ ント に 変換 し ます 。 

Graphics ク ラス な どの 3D 座 標 を サポ ー ト し な い ク ラス で 3D 図 形 の 描画 を 
行う 場合 、3D=>2D の 座標 変換 が 必要 に な り ま す 。 こ の メソ ッ ド で 3D 座 標 
を 変換 する こと に より 、 複 雑 な 計算 を 独自 に 行う 必要 は な く 、3D 座 標 の み 
を 用 意 し て 奥行 き の あ る 図形 を 描画 する こと が で きま す 。 

3D 座 標 を 持つ Vector3D オ ブ ジ ェクト を 作成 し て パラ メー タ (point3d) に 
渡す こと で 、2Z 次 元 の 座標 を 持つ Point オ ブ ジ ェクト が 返さ れ ま す 。 































1oca13DToG1oba1] ( 
POo1n キ 3d: 
VeCtOr3D ) : Po ュ 1n ヒ 










特 PerspectiveProjection クラ ス の 主 な プロ パテ ィ 概 要 


プロ パテ ィ 名 プロ パテ ィ の 概要 


速 近 法 の 消失 点 を 設定 する projectionCenter プ ロ パ ティ は 、 遠 近 法 投影 
: PO1n 






田 






の 消失 点 を 表し ます 。 


遠近 法 の 視野 を 角度 で 指定 | fie1dOEView 遠近 法 投影 の 強度 を 決定 する 0 一 180 度 の 角度 
する : Number を 指定 し ます 。 


遠近 法 の 焦点 の 長 さ を 取得 | Eoca1Length 視点 の 原点 (0.0.0) と z 軸 上 の 表示 オブ ジェ ク 
(設定 ) する : Number ト の 位置 と の 間 の 距離 を 表し ます 。 












暫 Matrix3D クラ ス の 主 な プロ パテ ィ 概 要 


対象 オブ ジェ クト の 3D | position 3D 処 理 を 行っ て いる オブ ジェ クト の 現在 の 3D 座 標 位置 を 
座標 を 調べ る : VGCO エ 3D 保持 する Vector3D イ ンス タン ス を 参照 し ます 。 


乱 Matrix3D クラ ス の 主 な メソ ッ ド 概要 


X/y/z 軸 で の 回 転 を | appendRotation ( 
加え る degree8 : Number , 
ax18 : VeCt 上 Or3D, p1votPoint : 
Vector3D = nu11 ) 
: VO1d 





メソ ッ ド の 概要 


指定 し た 角度 と 軸 を 中 心 と し た 回 転 を 
Matrix3D オ ブ ジ ェクト に 追加 し ます 。 
その オブ ジェ クト を 表示 オブ ジェ クト に 
適用 する と 、appendRotation() メ ソ ッ 
ド の 場合 、 他 の 変換 の 後に 回 転 が 実行 さ 
れ ま す 。 prependRotation() メ ソ ッ ド の 
場合 、 他 の 変換 の 前 に 回 転 が 実行 さ れ ま 
す 。 









































PrepenQdRotat1on ( 
degree8 : NumDer, ax18 : 
Vec 上 Or エ 3D , Dp1VotPoint : 
Vector3D = nul11) 

: マ O1d 






X/y/z 軸 方 向 に 拡大 
/ 縮 小 を 行う 


X/y/z 軸 方 向 の 位置 
を 移動 する 


Matrix3D オ ブ ジ ェ 
クト の クロ ー ン ( コ 
ビー) を 作成 する 


逆 の 変換 を 行う 反 
転 行列 を 作成 する 
別に 作成 し た Matrix 


3D オ ブ ジ ェクト を 
追加 する 


乱 Matrix3D ク ラス の 主 な メソ ッ ド 概要 (続き ) 


メソ ッ ド 名 メソ ッ ド の 概要 


appendSca]e ( 
xSoa1e : NumDer , 
ySca1e : NumDer , 
zSoa] e : NumDber ) 
: VO1d 


prepenQdSoale ( 
xSCa1e : Number , 
ySca1e : NumDer , 
ZSCa16e : NumDber ) 
: マ O1d 


appenQdTranslat ュ on ( 
X : NumDer , 

Y : NumDer , 

2 : NumDer ) 

: VO1d 


prependTransl1ation ( 
X : NumDer , 

Y : NumDer , 

2 : NumD@r ) 

: YO1Q 


Clone ( ) : Ma エエ 1x3D 


1nVer ( ) : Bool]ean 


append ( 1hs : Matr1x3D ) : Vo1d 


prepend (rhgs : Ma 上 1x3D) :Vo1d 
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指定 し た 軸 上 の 拡大 / 縮 小 を Matrix3D オ 
ブ ジ ェクト に 追加 し ます 。 そ の オブ ジェ 
クト を 表示 オブ ジェ クト に 適用 する と 、 
appendScale() メ ソ ッ ド の 場合 、 他 の 変 
換 の 後に 拡大 / 縮 小 が 実行 され ます 。 pre 
pendScale() メ ソ ッ ド の 場合 、 ほ か の 変 
換 の 前 に 拡大 / 縮 小 が 実行 され ます 。 


指定 し た 軸 上 の 位置 の 変更 を Matrix3D 
オブ ジェ クト に 追加 し ます 。 そ の オブ 
ジェ クト を 表示 オブ ジェ クト に 適用 する 
と 、appendScale() メ ソ ッ ド の 場合 、 他 
の 変換 の 後に 位置 の 変更 が 実行 され ます 。 
prependScale() メ ソ ッ ド の 場合 、 他 の 


変換 の 前 に 位置 の 変更 が 実行 され ます 。 


現在 の Matrix3D オ ブ ジ ェクト の コピ ー 
を 返し ます 。 


現在 オブ ジェ クト が 持っ て いる マト リッ 
クス を 反転 し た オブ ジェ クト を 返し ます 。 


別 の Matrix3D オ ブ ジ ェクト を 現在 の オ 
ブ ジ ェクト に 追加 し ます 。 追加 後に 表示 
オブ ジェ クト に 適用 する と 、append() 
メソ ッ ド の 場合 、 他 の 変換 の 後に 追加 し 
た 内 容 が 実行 され ます 。prepend() メ 
ソ ッ ド の 場合 、 他 の 変換 の 前 に 追加 し た 
内 容 が 実行 され ます 。 
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=W 画 細 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


KN て ST ペタ こま TYO 
3 AN よこ いさ うつ だい KS あこ COA0 く 人 な こい を 7 ん の ルン KK も の が 
NAKED AN に SAASKAKKZGOK2KSCKnSSO マン om 
人 が RS NoxcCSs YA SC ) | 
失 Do SNR 1 





ル (F) 表示 (y) 刷 御 (C デバ ッ グ (D) 
TOtatiOnX 
OtatIOnY 


ュー 


rotation〆 


弓 へ MMPLE ヒロ ロ E EE 


シン ブル な 3D ア ニメーション 3DSampieA.fla 


1mport Fl]ash.display . Shape : 

1mport Fl]ash.disp1ay . SDr ユ Ge: 

1mport flagsh . eveng . Eve : 

/ /Rotation の 基準 と する 変数 

Ya X エ : 1n ヒ =0 : 

Var Y エ :1n ヒ =0: 

Va 2 : ユ n ヒ =0 

/ / 図 形 オ ブ ジ ェクト 

Va 8:Shape : 

Function nit () :void 1 
/ / 対象 の 図形 を 描画 
drawShape ( ) 
// フ レー ムレ ー ト の タイ ミン グ で 負 理 を 行う た め の イ ベン トバ ハン ドラ 登録 
this .addEventL1stener (Event . ENTER FRAME, enEterFrameFumC1On8) : 
/ /rotation 
rotationX ns.addEventTListener ( Event .CHANGE , setRotation ): 
rotationY ns.addEventListener ( Event .CHANGE, setRotat1on ): 
rotationZ ns.addEventL1stener ( Event .CHANGE, setRotat1on ): 
// リ セッ ト ボ タン 


reset btn.addEventLigstener( MouseEvent .CLTCK, resetShape ): 


7-10-1 
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Function drawShape ( ) :vo1d 1 


) 


/ / す で に 描画 し て いた ら 、 ク リア 

1f ( g != nu]] ) g.qraphics .clear() : 一 一 ③ 
8 = new Shape ( ) : 

8 .draphics .11neStyle( 1, OxfEfE0000, 0.8 ): 


⑯ 


8 .draphics .beg1nF111( Ox00fFfF00 ): 

8 .draphics .drawRect(50, -50, 100, 100): 
8 .x=8taqe . StageW1dth/ 2 : 

8 .Y=Stage . 8tageHe1qh/2 : 

this .addChi1d (8) 


Funotion resetShape (event : MouseEven ) :Yoid { 


) 


/ /NumericStepper の 値 を リセ ッ ト 
rotationX ns.Value = 0: 
rotat1ionY ns.Value = 0: 
rotat1ionZ ns.Value = 0: 

/ / ここ で 渡す event 上 は ダミ ー 
getRotation (even) : 

/ / シ ェ イ プ を 再 描画 

drawShape () : 


Funotion enterFrameFunotion (event : Event ) : Vo1d 1 


) 


/ / 変 数 の 値 に より 、3D パ ラメ ー タ を 更新 
8 .Y エ Ota 上 1OnX += メ 了 エ : の 
8 . エ Ota 上 1OnY += Y エ : 


8 .Yota 上 1onZ += 2Z エ : 


Funotion setRotation (event : Event ) :Yoid 1 


) 


/ /NumericStepper か ら 値 を 取り 出し て 変数 に 代入 

メ エ = エ Oa1onX ng8.Ya1ue : 

rotationX xt .Eex ヒ =rotationX ns.Ya1ue . 上 OStr1nd () : 
Y エ = エ Otat1OnY ng .Ya1ue : 

rota1onY xt .Eex ヒ =rotationY ns.yalue .tOStr1nd() : 
Z エ = エ Ota1onZ nm8.Ya1Uu6G: 


rota1onZ 上 x .EGx ヒ =rotat1ionZ ns.Va1ue .EOSt エ 1nd () : 


1n1 ( ) : 


10 
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この サン ブル で は 、3D 操 作 の 基本 と な る Rotation プ ロ パ ティ の 値 を 変化 させ ます 。 表 示 オ 
ブ ジ ェクト が 持つ RotationX、RotationY、RotationZ は それ ぞ れ x 軸 、 y 軸 、 z 軸 を 基準 に 
し た 回 転 角度 を 表し ます 。 こ の プロ パテ ィ を 連続 的 に 変化 させ る こと で 、 動 き の あ る 3D ア ニ メ 
ーション を 作成 する こと が で きま す 。 

② の drawShape() 関 数 で 対象 の Shape オ ブ ジ ェクト を 作成 し て 表示 し て いま す 。 回 転 角度 
を 表す 変数 は で 宣言 し て いる 変数 で す 。RotationX/Y/Z プ ロバ パテ ィ は Number 型 で す が 、 こ 
こ で は 整数 値 で 問題 な いた め 、int 型 で 作成 し て いま す 。 回転 の プロ バテ ィ を 変化 させ る の は 、 
④ の enterFrameFunction() 関 数 で 行っ て いま す 。 回 転 を 加え る と 表示 オブ ジェ クト の 形状 は 
その 回 転 状態 を 表す 形 に 変化 し 、 軸 も 変化 し て し まう の で 、 リ セッ ト し て 最初 の 状態 に 戻す ボ 
タン を つけ まし た 。 ボ タン を 押し た と き の 処 理 は ② の drawShape() 関 数 を 呼び 出し て いま す が 、 
この 関数 は init() 初 期 処 理 で も 描画 の た め に 使用 し ます 。 そ の た め 、3 で 行っ て いる よう に す で 
に 描画 し て いる と < 変数 に 値 が 入っ て いる の で 、 そ の と き は Graphics ク ラス の clear() メ ソ ッ ド 
を 呼び 出し て 古い シェ イプ を 消し て いま す 。 


「CLatiOnX 


『OtatiIOnY 


rotatiOn〆 


ュー 


リセ ッ ト 。 | 


rotationX/rotationY の 変化 値 を 与え る と 、x 軸 で 回 転 し な が ら y 軸 で 回 転 を 続け ます 。 


PerspectivePr 1 


オブ ジェ クト で 避 近 法 を 使う 


PerspectiveProjection ク ラス は 、3D 空間 で 表示 オブ ジェ クト に 基本 的 な 遠近 法 に よる 変 
形 を 適用 する こと が で きま す 。 遠近 法 に よる 投影 を 行わ な い 場 合 も デフ ォ ル ト の 設定 値 に よる 
PerspectiveProjection オ ブ ジ ェクト が 使用 され ます 。 デ フォ ルト で は 、Flash Player に よっ 
て ステ ー ジ の 中 央 が 消失 点 と し て 自動 的 に 設定 され ます 。 消 失点 は z プ ロバ ティ を 増大 させ て ユ 
ー ザ か ら 遠 ざけ る と き に すべ て の オブ ジェ クト が 収束 する 点 で す 。 





s PS クラ ス の 遠近 法 投影 の た め の プ ロバ ティ 詳細 


nCener 遠近 法 投影 の 消失 点 を Point オ ブ ジ ェクト で 表し ます 。 こ ステ ー ジ の 左上 隅 
を 消失 点 と する 場合 、 オブジェ クト が 持つ 座標 値 を (0.0) に し ます 。 表 示 オ 
ブ ジ ェクト を ユー ザ か ら 遠 い 方 へ 移動 させ る 場合 、 そ の オブ ジェ クト は 設 
定 し た 消失 点 に 向かっ て 収束 し 、 最 終 的 に 消失 し ます 。 ル ー ト に 作成 され 
る デフ ォ ル ト の PerspectiveProjection オ ブ ジ ェクト は ステ ー ジ の 中 央 を 表 
す projectionCenter 値 を 持ち ます 。 


遠近 法 投影 の 強度 を 決定 する 1 以上 180 未 満 の 角度 を 指定 し ます 。3 次 元 の 
視野 の 角度 を 変化 させ る こと に より 、3D 表 示 オ ブ プ ジ ェ クト が ユー ザ に 近 付 
く ほ ど 大 きく 表示 され 、 ユ ー ザ か ら 遠 ざさ か る ほど 小さ く 表 示さ れる よう に 
で きま す 。 

値 が 大 きい ほど 、z 軸 に 沿っ て 移動 する 表示 オブ ジェ クト に 適用 され る 歪み 
が 強く な り ま す 。 値 が 小さ い 場 合 、 移 動 す る オプ ジェ クト の 拡大 / 縮 小 が 少 
な く な り 、 オ ブ ジ ェクト は 空間 内 で 若 十 後 方 に 移動 する よう に 見 える の み 
に な り ま す 。 値 が 大 きい 場合 、 移 動 に 伴う 歪み が 大 きく な り 、 よ り 大 幅 に 
移動 し た よう に 見 えま す 。 最 大 値 の 180 度 に 近い 値 を 指定 する と 、 極端 な 
魚 眼 カ メラ レン スズ 効果 が 生成 され ます 。 

ルー ト に 作成 され る デフ ォ ル ト の PerspectiveProjection オ ブ プ ジ ェ クト は 
55 と いう fieldOfView 値 を 持ち ます 。 


Foca1Length 視点 の 原点 (0.0.0) と z 軸 上 の 表示 オブ ジェ クト の 位置 と の 間 の 距離 を 表し 
: Number ます 。 こ の 距離 は 焦点 の 長 さ と 呼ば れ ま す 。focalLength は 、 表 示 オ ブ ジ ェ 
クト が 移動 する と き の 遠 近 法 変 換 中 に 動 的 に 再 計算 され ます が 、 値 を 設定 
する こと も で きま す 。 
ルー ト に 作成 され る デフ ォ ル ト の PerspectiveProjection オ ブ プ ジ ェ クト は 次 
の 式 で 算出 され る focalLength 値 を 持ち ます 。stageWidth/ 2 * ( cos(field 
OfView/2) / sin(fieldOfView/2) ) 


























筆 PerspectiveProjection ク ラス の メソ ッ ド 詳細 


L 表示 オブ ジェ クト の 基 に な る Matrix3D オ ブ ジ ェクト を 返し ます 。 
: Ma エエ ュ x3D 
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民 電 E 瑞 表 -- - -- ----------------------------------ーーーーーーーーーーーーーーーーーーーーーーーーーー ニ ーーーー ニ ーー ニー ニーーーー 





ラ 」 3DSarmpleE 


EE OK - ーー SC CS OO EN や 








上 還 LUUMJAMU uuuuiu 引 問 症 







fieldOfView:55 


focalLength:768.392822 






PrOjettion て e rterX=9OO. y=300| 


※ 初 期 状 態 (消失 点 : ス テー ジ 中 央 、fieldOfView=55) 


= を = 上 コ 疾 mimle】 ヨ 蘭 - - ----------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


PerspectiveProjection オブ ジェ クト の プロ パテ ィ を 確認 する 3DSampleB.fla 


1mpor 上 fFlagsh.display . Shape : 
1mpor 上 Flash .deom . Po1n 七 : 
1mpor ヒ 上 Fl]ash.evens . EVen : 
1mpor Fl]ash .qeom . PSrSDGC 上 1VePro] ec 上 1on : 
// シ ェ イ プ 用 の 変数 
Var 8:ShaDpe : 
Funotion init() {1 
/ /perspectivePro]ection .Fie1dOFView を 1 (最小 に 近い 値 ) に し て お く 
Oo 七 . 上 ranSfFOrm .DGFSDeGC 上 1VePro] ection.Eie1dOEView = 1: 
//1000 個 の シェ イブ を 作成 
For (var 1:int = 0: 1 < 1000: 1++) { 
8 = new Shape ( ) : 
/ / 色 を ラン ダム に ① 
8 .draphicCs .beg1nFi1 1 (Math . random ( ) * OxFEFFEFEFF ) : 
8 .draph1ocs .drawRect( -5, -5, 5, 40 ): 
/ /x 座 標 を ステ ー ジ 幅 を 最大 と する ラン ダム 値 に 
8 . メ =Mah . random ( ) *stage . stadeW1dh : 
/ /y 座 標 は ステ ー ジ の 中 央 
8 .=Stage . staqgeHe1gh / 2 : 


ーー ば 
PerspectiveProjection オ ブ ジ ェクト で 遠近 法 を 使う 


/ / z 座 標 を 0 一 8800 未 満 の ラン ダム 値 に 
8 .z=Math .random()*8800: 
adqdChi1d( 8 ): 
① 
/ / マ ウス クリ ッ ク ハ ンド ラ の 登録 
8tage . addEventTLi1 stener (MouseEvernt .CLTCK, chanqgePP ): 
8howTnfo() : 
) 
Function changePP (event : MouseEvent ) :vo1d { 
/ / マ ウス を クリ ッ ク し た 座標 を perspect 上 ivePro]ec1on .Dro]ect1onCente エ に する 
8etRoo ( eVen . gEaqdeXX, @V@ 妨 に . BEad@Y ) : 一 一 ーーーーーーーーーーーーーーー @ 
8howTnfo() 


) 


Function getRoot (x : Number, Y:Number) :vo1d { 


ーー 
回: 


/ /perspec 上 1vePro] eo 上 1on .Dro] ec 上 1onCente を 変更 
Oo . 上 ram8fFOrm .DGFSDGC 上 1VGPrO] GC 上 1On . DFO]GC 七 1onCen ヒ er=new 
Po1n (XX,) : 

) 

// ス ライ ダー の イベ ント ハン ドラ 登録 

Fv.addEventListener ( Event .CHANGE, setFie1dOFEView ): 

/ /perspectivePro]ection .Fie1dOFView を 変更 する 関数 


Function setFie1dOFView ( e:Event ) :void { 





rOot . transfForm .DGrSDeGC 上 1VePro]eGCt1on.Fie1dOFV1ew = 上 FV.Va1uG: 


8howTnfo ( ) : 


) 


Funotion ghowTnfo ( ) :vo1d { 


FV 上 xt .ext = "Fie1dOEV1ew:" + 上 V.Ya1ue: 

F] tx .EexEt = "Fooal1LenqIh : " + OO .ran8fFO エ m . 
PerSDeGC1VeGPro] ecCt1on . Foca]LienqgEh : 

pC xt .text = "prO]eCt1onCenter : " + OO .tran8fFOrm . 


Der8pec 上 ivePro]ection .pro] ectionCenter . 上 OS 上 rindg ( ) : / / as Poin : 


) 


1ni ( ) : 


の init() 関 数 で 1000 個 の シェ イプ を ラン ダム な 場所 に 作成 し ます 。z 座 標 も ラン ダム に する 

た め 、 消 失点 に 向かっ て 遠く な っ て ゆく イメ ー ジ を 作成 し て いま す 。 た だ し 、 コ ー ド を シン プ 

ル で わか りや すく する た め に オブ ジェ クト の 重ね 合わ せ の 調整 を し て いな いた め 、 よ く 見 る と 

奥 に ある は ず の シェ イブ が 前 面 に 描画 され た り し て いま す 。@②⑥ で マウ ス を クリ ッ ク し た 座標 を 
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perspectiveProjection.projectionCenter に し て いま す 。 こ れ に より 、 消 失点 の 位置 が 変わ 
り 、「 も っ と も 遠い 地点 」 が 変化 し ます 。 ス テー ジ 右 下 に 配置 し た スラ イダ ー コ ント ロー ル で 
perspectiveProjection.fieldOfView の 値 を 変更 し 、 結 果 を 確認 で きま す 。 変更 は (3 で 行っ て 
いま す 。 





時 2 ロス テー の ーーーーーー" ーー 


Pd た. Sa の が s = 3 
- ア ィ we 表示 の WO ty グ 0D) 


focalLength:45835.46O9 
PojectionCenterix=4O0. y =300] 


6 用 Wi | 


【 LN NT 


リ 作 
MO | 


fieldOfView:30 ーーーーーーーーーーーーーーー ーー 


focalLength:1492.82031 
PottiohCentei:lX=1。 y=1) 





プー 1 サー 
PerspectiveProjection オ ブ ジ ェクト で 遠近 法 を 使う 


較 消失 点 : ステ ー ジ 左上 (1.1)、 fieldOfView=90 





nta し 2 
YK=1, = 


消失 点 : ス テー ジ 左 上 (1,1)、 fieldOfView=170 
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Matrix3D ク ラス に 用 意 さ れ た メソ ッ ド に より 、 オ ブ ジ ェクト の 移動 や サイ ズ 変 更 、 回 転 を 
行う つう ため の 3D 座 標 変換 を 行う こと が で きま す 。 変換 は 表示 オブ ジェ クト の プロ パテ ィ や メソ ッ 
ド を 使用 し て 1 つ ず つ 行 うこ と が で きま す が 、Matrix3D オ ブ ジ ェクト に より 複数 の 変換 を 1 回 
で 効率 的 に 行う こと が で きま す 。 た だ し 、 適 用 する 変換 の 種類 と パラ メー タ が それ ぞ れ 同じ で 
も 、 個 々 の 変換 を 適用 する 順序 に より 最終 結果 が 大 きく 異な る の で 注意 が 必要 で す 。Matrix 
3D オ ブ ジ ェクト は 変換 用 の デー タ を 下図 の よう な 4 行 x4 列 の 行列 で 保持 し 、 こ れ は 変換 マト 
リッ クス と 呼ば れ ま す 。 た だ し 、 こ の マト リッ クス の 詳細 を 数 学 的 に 理解 する 必要 は あり ませ 
ん 。 表 示 オ ブ ジ ェクト に Matrix3D オ ブ ジ ェクト に よる 変換 を 行う 場合 の 基本 手順 と し て 、 ま 
ず 表 示 オ ブ ジ ェクト が 持つ Matrix3D オ ブ ジ ェクト を 取得 し 、 そ れ に 対し て 変換 メソ ッ ド を 直 
接 実行 する 方 法 と 、 独 自 の 変換 パラ メー タ を 設定 し た Matrix3D オ ブ ジ ェクト を 作成 し 、 適 用 
(追加 ) す る 方 法 が あり ます 。 表 示 オ ブ ジ ェクト が すでに Matrix3D オ ブ ジ ェクト を 持っ て いる 
場合 、 そ の オブ ジェ クト は transform プ ロ パ ティ で 参照 で きる Transform オ ブ ジ ェクト の 
matrix3D プ ロバ ティ で 取得 で きま す が 、 デ フォ ルト で は 作成 され な いた め 、 下 表 の いずれ か 
の 操作 に より 、 あ ら か じ め Matrix3D オ ブ ジ ェクト を 生成 し て お く 必 要 が あり ます 。 


較 Matrix3D オ ブ ジ ェクト の 変換 マト リッ クス 


方 向 秋 換 
SCaleX 0 0 t 
0 ScaleY 0 1 
0 0 SCaleZ 9 
0 0 0 t。 


表示 オブ ジェ クト に 対す る Matrix3D は 3D に 関連 する プロ パテ ィ を 設定 する こと で 自動 的 に 生 
成 さ れ ま す 。 例 えば 、z プ ロ パ ティ に 数 値 0 を 設定 する こと で 、 オ ブ ジ ェクト の 位置 を 変更 し な 
いで Matrix3D オ ブ ジ ェクト を 生成 で きま す 。 





Matrix3D イ ンス タン ス を 明示 的 に 生成 し ます 。 コ ンス トラ クタ に パラ メー タ を 渡し て 独自 の 変 
換 を 行う た め の オ ブ ジ ェクト を 作成 で きま す 。 


ルー ト 表 示 オ ブ ジ ェクト の perspectiveProjection.matrix3D プ ロ パ ティ に より 、 ス テー ジ 上 の 
3D オ ブ ジ ェクト の 表示 を 制御 する Matrix3D オブ ジェ クト を 取得 で きま す 。 





7-10-3 
Matrix3D オブ ジェ クト を 使う 


息 Matrix3D クラ ス の 主 な メソ ッ ド 詳細 


メソ ッ ド 名 メソ ッ ド の 概要 「 “ 




















指定 し た 角度 と 軸 を 中 心 と し た 回 転 を Matrix3D オ ブ ジ ェ ク 
ト に 追加 し ます 。appendRotation() メ ソ ッ ド は 他 の 変換 の 
後 、prependRotation() メ ソ ッ ド は 他 の 変換 の 前 に 指定 し た 
回 転 が 実 行 さ れ ま す 。 
degrees : Number 適用 する 回 転 の 角度 で す 。 
axis : Vector3D Vector3D ク ラス の 定数 で 回 転 の 軸 を 指定 
し ます 。 

Vector3D.X_AXIS: x 軸 を 表し ます 。 

Vector3D.Y_AXIS: y 軸 を 表し ます 。 

Vector3D.Z_ AXIS: z 軸 を 表し ます 。 
pivotPoint:Vector3D オ ブ ジ ェクト 回 転 の 中 心 を 決め る 3D 
座標 ポイ ント で す 。 


指定 し た 軸 上 の 拡大 / 縮 小 を Matrix3D オ ブ ジ ェクト に 追加 し 
ます 。appendScale() メ ソ ッ ド は 他 の 変換 の 後 、prepend 
Scale() メ ソ ッ ド は 他 の 変換 の 前 に 拡大 / 縮 小 が 実行 され ます 。 
拡大 / 縮 小 は 乗数 、 つ まり 掛け 算 の 値 で 設定 し ます 。1.5 の 設 
定 値 は 1.5 倍 の 拡大 に な り ま す 。 変更 を 行わ な い 軸 の 値 は ] 
に し て お きま す 。 

xScale:Number x 軸 方 向 の 拡大 / 縮 小乗 数 で す 。 

yScale:Number y 軸 方 向 の 拡大 / 縮 小乗 数 で す 。 
zScale:Number z 軸 方 向 の 拡大 / 縮 小乗 数 で す 。 









apDpenQdRotat ュ on ( 
dedree8 : NumDer , 
ax18 : VecCtor3D, p1VoPon : 
Vector3D = nu11) 
:VO1d 

























prependRotat1on ( 
Qdeqree8 : NumDer, ax18: 
VecCtor3D , D1VotPo1in : 
Vector3D = nu]1]1 ) 
:・V 〇 1d 






















appendScale ( 
xSCa1e : NumDer , 
YSCa1e : NumDer , 
zSCa1e : NumDer ) 
:VO1d 












prependSoale ( 
xSoa1e : NumDer , 
ySca」e : NumDber , 
zSCa16e : Numbe+r ) 
:VO1Q 
























指定 し た 軸 上 の 位置 の 変更 を Matrix3D オ ブ ジ ェクト に 追加 


appendTrang1at1on ( 






x: NumDber , し ます 。appendScale() メ ソ ッ ド は ほか の 変換 の 後 、pre 
y : Number, pendScale() メ ソ ッ ド は ほか の 変換 の 前 に 位置 の 変更 が 実行 
z : NumDer ) され ます 。 位置 の 変更 は 増分 、 つ まり 現在 の 位置 に プラ ス す 


:VO1d る 数 値 を 設定 し ます 。10 の 設定 値 は 指定 し た 軸 方 向 に 10 移 
動 し ます 。 位置 を 変更 し な い 軸 の 値 は ひつ に し て お きま す 。 
x:Number x 軸 方 向 の 位置 の 増分 で す 。 
y:Number y 軸 方 向 の 位置 の 増分 で す 。 


z:Number z 軸 方 向 の 位置 の 増分 で す 。 
























prependTrans1at1on ( 
メ : NumDer , 
Y : Number , 
Z : NumDer ) 
: VO10d 


clone ( ) :Matrix3D 現在 の Matrix3D オ ブ ジ ェクト の コピ ー を 返し ます 。 既存 の 
Matrix3D オ ブ プ ジ ェ クト に 変換 メソ ッ ド を 実行 する と 、 そ の 
オブ ジェ クト が 保持 し て いる マト リッ クス が 変更 され て し ま 
いま す 。 変換 前 の オリ ジ ナ ル マ ト リッ クス を 保持 し て お きた 
いと き は 、clone() メ ソ ッ ド で コピ ー を 作成 し て か ら 変 換 を 
加え ます 。 


invert ( ) : Boo1ean 現在 オブ ジェ クト が 持っ て いる マト リッ クス を 反転 し た オブ 
ジェ クト を 返し ます 。 反転 し た マト リッ クス に より 、 行 っ た 
変換 を 元 に 戻す こと が で きま す 。 


別 の Matrix3D オ ブ ジ ェクト を 乗算 に より 、 現 在 の オブ ジェ 
クト に 追加 し ます 。append() メ ソ ッ ド は 他 の 変換 の 後に 、 
prepend() メ ソ ッ ド は 、 他 の 変換 の 前 に 追加 し た 内 容 が 実行 
され ます 。 









append (1hs :Matr1x3D) :Vo1d 


prepend (rhg : Ma 上 1x3D) :VO1d 
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トニ < パ IMv1 F 13 | 回 ie 
時 ” 0 テン ョ の MO SS SS の eS の ES ここ NG < と で CO の だ > や kp ー こ 
色 K に 0 CZ XX 四 





fie ldOfView:55 


focalLength:768.392822 
し 『O06 の 30 赦 四 。 」 | ジェ イブ の 30My を 実 臣 | otioncenerxs26,y=61) 





※projectionCenter: (26.61) 


EEEI 間 表 半 -------------------ーー ニ ーーーーー ニ ーー ニー ニー ニニ ーーー ニ ニニ ーーー ニー ニニ ーー ニー ニー ニニ ーー ニー ニニ ーー ニー 


Matrix3D に よる 変換 3DSampleC.fla 


1mpor 上 Flash.d1splay . Shape : 
1mporE Fl]asgh .qeom . Point : 
1mport fl]ash . evens . Event : 
1mpor 上 Fl]ash .qeom . Per8pDect ivePro] @GCt 1on : 
1mpor 上 fF]ash .qeom . Vector3D: 
// シ ェ イ プ 用 の 変数 
Var 8:ShaDpe : 
Var 8hap@e8 :A 了 と aY : 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ① 
Var CurShape : ShaDe : 
/ /Matrix3D オ ブ ジ ェクト 用 の 変数 
Var ma キ 3 :Matrix3D: 
/ / 初期 処理 関数 
Funoction init() { 
Shape8 = mew Ar エ aY () 
/ /perspectivePro]ection .F1ie1dOFView を 1 (最小 に 近い 値 ) に し て お く 
OO . 上 ram8FO エ m . DGTSDGC 上 1VGPrO] GCC 上 1on .F1ie1dOFV1ew=55 : 
//1000 個 の シェ イブ を 作成 
For (Var 1:inE = 0: 1 < 1000: i++) { 
8 = new Shape ( ) : 
/ / 色 を ラン ダム に 


) 


7-10-3 
Matrix3D オブ ジェ クト を 使う 


8 .draphios .beginF1i11 (Math . random() * OxFFFFEFF) : 
8 .draphics .drawRect( -5, -5, 10, 60 ): 

/ /x 座 標 を ステ ー ジ 幅 を 最大 と する ラン ダム 値 に 

8 .x=Math . random ( ) *gtage . SLadeW1dth: 

/ /y 座 標 は ステ ー ジ の 中 央 

8 .Y=8tage . StageHe1qh キ /2 : 

/ / z 座 標 を 0 一 8800 未 満 の ラン ダム 値 に 

8 . 2=Math . random() *8800: 


addChi1d( gs ): 
/ / シ ェ イ ブ を 配列 に 格納 
ghapes .pu8h( 8 ) , 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー (② 
) 
/ / マ ウス クリ ッ ク ハ ンド ラ の 登録 


stage . addEventLii stener (MouseEvent .CLTCK, changePP ): 

// シ ェ イ プ の 3DMatrix を 変更 ボタ ン イ ベン トバ ハン ドラ 

mat btn.addEventListener (MouseEvent .CLTCK, setMat ヒ エ ュ 1x3D) : 

/ / root 上 の 3DMat ェ ix を 変更 ボタ ン イ ベン トバ ハン ドラ 

matroot btn .addEventListener (MouseEvent .CLTCK, getMat エ 1x3DrOC ) : 


8howTnfo() 


Function changePP (event : MouseEvent ) : void { 


1f (event .targe キ ==thig .EY) 1{ 
GEUTT 』 


) 


if (event .target==this .mat btn| | event .targe==this .matroot btn) { 
Sbh の 6 

} / / マ ウス を クリ ッ ク し た 座標 を perspectivePro]ect1on .pro] ec 上 1onCenter に する 

SetRoot ( event . stagqeX, even .staqeY ): 


ShowTnfo() 


Function setRoot (x : Number, Y:Number) :Vo1d { 


) 


/ /pergspectivePro] ec 上 1on .Dro] ect ionCenter を 変更 


YOOt . 上 ran8fForm .DGFSDGC 上 1 ヾ GPrO] 6 で 上 1On . DrO] GC 上 1OnCen 七 G エ =mGw PO1n 上 


(XX,Y) : 


// ス ライ ダー の イベ ント ハン ドラ 登録 
fy . adQdEventTLii stener ( Event .CHANGE, setFie1dOFEView ): 


/ /perspectivePro]ection .Fie1dOFV1iew を 変更 する 関数 
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Funoction setFie1dOFView( e:Event ) :vo1d { 
OO . 上 ran8FO エ rm .DGFSDGC 上 1VePrOo] GCC 上 1on .Fie1dOEFV1ew=Fv .Ya1ue : 
8howTnfo() : 
) 
Funotion showTnfo ( ) :void { 
FV x . 上 ex 上 ="F1e1dOFEV1ew : リ + 上 V .Ya1ue : 
F] Ex .tex キ = "Fooa1Lengh : リ + エ oo . 上 ran8fForm .DGrSDeGC 上 1VePrO] ect1on . 
FocalTLienqth: 
PC xt . 上 ex 上 = "pro]eGCt1onCenter : "+ エ Oo . 上 ran8SfFormm . 
PeGrSDGC 上 1VGP エ O]GCt1on . pro]ect 1onCenter . 上 toString ( ) : / / ag Poin: 
) 
/ / 表 示 オ ブ ジ ェクト ルー ト の 変換 を 行う 関数 (イベ ント ハン ドラ ) 
funct1on setMarix3Droot (event : MouseEvent ) :vo1d { 
th1gs .2=0: 
/ /Matrix3D オ ブ ジ ェクト を 取得 
ma ヒ 3= エ Oo . 上 ram8fForm . ma ヒエ 1x3D : 
ma3 .appendRotat1on (3 , Vector3D.Y AXTS ): 
ma 七 3 .appendRotat ュ on (3 , Vector3D.Z AXTS ): 
ma 七 3 .appenQdRotat ュ on (3 , Veoctor3D.X AXTS )。: 
/ /Mat 上 rix3D オ ブ ジ ェクト を 適用 
thisgs .transfForm . mat 上 rix3D=ma 七 3 : 
) 
// シ ェ イ プ オ ブ ジ ェクト ルー ト の 変換 を 行う 関数 (イベ ント ハン ドラ ) 
Function setMatrix3D (event :MouseEven ) :vo1d {1 
for (Var 1:inE = 0 1 < 1000: 1+=2) { 
CurShape=8hapes [1] as Shape: 
/ /Matr1x3D オ ブ ジ ェクト を 取得 
mat 上 3=CurShape . 上 ransform . ma 上 r1x3D 
ma 上 3 . appendRotat ュ on (3 , Vector3D.Y AXTS ): 
ma 七 3 .appendRotat ュ on (3 , Vector3D. AXTS ): ④ 
ma 上 3 . apPpendRota ュ on ( 3 , Vector3D.X AXTS ): 
/ /Matrix3D オ ブ ジ ェクト を 適用 
CurShape.. 上 rangsfForm . ma ヒエ 1x3D=ma3 : 
/ / 区 別 す る た め に アル ファ 値 を 変更 
CurShape .a1pha=0 .5: 


1n1 七 ( ) : 


7-10-3 
Matrix3D オ ブ ジ ェクト を 使う 


葉 訓 用 の サン プル を 修正 し て Matrix3D オ ブ ジ ェクト に よる 変換 を 適用 する よう に し て いま 
す 。「 表 示 オ ブ ジ ェクト の Matrix3D オ ブ ジ ェクト を 作成 する 方 法 ] に あげ た 方 法 の うち 、2 と 3 
の 処理 を 行う サン プル で す 。 ま ず 2. の 方 法 を 行う た め に 、 作 成 し た シェ イプ を 格納 し て お く 配 
列 を 用 意 し (① の shapes 変 数 )、 作 成 し た シェ イプ を ②⑫ で 格納 し て いま す 。④ の 関数 で すべ て の 
シェ イプ オブ ジェ クト の うち 半分 に Matrix3D に よる 変換 を 適用 し て いま す 。 表 示 オ ブ ジ ェ ク 
ト の ルー ト 自 体 を 変換 する 処理 は ③ の 関数 で 行っ て いる よう に 、 まず this( こ の 場合 root と 同じ ) 
オブ ジェ クト の z プ ロ パ ティ に 0 を 代入 し て Matrix3D オ ブ ジ ェクト を 生成 し て か ら 、 変 換 の メ 
ソ ッ ド を 適用 し ます 。 結果 の イメ ー ジ で わか る よう に 、 ル ー ト オブ ジェ クト の 座標 回 転 を 行う 
と 、 ス テー ジ 全 体 に 変換 が 適用 され る 形 に な り ま す 。 


* シェ イ ブ の : EE ーー 


ーーーー 提 O 9(O デバ ッ ク (5 ー 
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8 一 | ビッ トマ ッ プ 
ビッ トマ ッ プ を ロー ドレ し て 表示 する 





Flash で は ベク ター グラ フィ ッ ク と 、 ビ ピット マッ プ グ ラフ ィ ッ ク の どちら も 表示 、 操 作 が 可 
能 で す 。 ピ ビ ピット マッ プ グ ラフ ィ ッ ク は その 目的 と 圧縮 形式 な どの 違い に より いく つか の ファ イ 
ル 形 式 が あり ます 。Flash で ロー ド 可 能 な ビッ トマ ッ プ グラ フィ ッ ク 形 式 を 下 表 に 挙げ ます 。 
ActionScript で ビッ トマ ッ プ を サー バ か ら ロ ー ド し て 表示 する に は 、Loader ク ラス オブ ジェ 
クト で ロー ド を 行い 、Bitmap ク ラス オブ ジェ クト で 表示 を 行い ます 。 ロ ー ド が 終了 し た 場合 、 
Loader オ ブ ジ ェクト の contentLoaderInfo プ ロバ ティ で 参照 で きる LoaderInfo オ ブ ジ ェ ク 
ト に Event.COMPLETE イ ベン ト ( エ ラー の 場合 、IOErrorEvent.IO_ERROR イ ベン ト ) が 送出 
され る の で 、 こ れ ら の イベ ント ハン ドラ で ロー ド し た ファ イル を 処理 で きま す 。 ロ ー ド 終了 後 、 
Loader オ ブ ジ ェクト の content プ ロ パ ティ で ロー ド し た 画像 デー タ を 取得 で きる の で 、Bit 
map オ ブ ジ ェクト を 取り 出し 、 表 示 処 理 を 行い ます 。 


m Flash で ロー ド / 操 作 可 能 な グラ フィ ッ ク 形 式 


BMP (ビッ トマ ッ プ ) Windows の 標準 イメ ー ジ 形式 で 、 通 常 圧 縮 を 行わ な い の で 劣化 を 防ぐ こと が 
可能 で す 。 ピ クセ ル 形 式 の イメ ー ジ は 一 般 に 「 ビ ッ ト マ ッ プ 」 と 呼ば れ ま す が 、 
BMP 形式 を 意味 する も の で は あり ませ ん 。 








JPEG (ジェ ー ペ グ ) 圧縮 を 行い ファ イル サイ ズ を 小さ く で きる の で 、Web 上 の イメ ー ジ 、 特 に 
写真 の 表示 に も っ と も よく 使用 され ます 。 フ ルカ ラー と 呼ば れる 1600 万 色 に 
対応 し て いま す 。 保 存する た びに 劣化 が 生じ ます 。Flash Player 7 以前 で は 
プロ グレ ッ シ ブ JEPG 画 像 を 表示 する こと は で きま せん 。 








GIF (ジフ ) 256 色 以下 の 色 数 に 限定 され る た め 、 ファ イル サイ ズ が 非常 に 小さ く な り ま す 。 


アイ コン や ボタ ン 画 像 な ど に も っ と も よく 使用 され ます 。 








PNG (ピン グ ) フル カラ ー に 対応 し 、 劣 化 の な い 圧 縮 方 式 を 使用 する 新しい 形式 。 古 い ブ ラ 
ウザ で は 表示 で き な い ケー ス が ある 。256 レ ベル の アル ファ 透明 度 も サボ ポー 
ト さ れ ま す 。 





TIFF (ティ フ ) 多く の 画像 編集 アプ リ が 対応 し て いる 汎用 的 な 形式 で す が 、 自由 度 が 高い た 
め 異 な る 形式 が 多く の 種類 が 存在 し ます 。 ブ ラウ ザ は TIFF の 表示 は サポ ー ト 
し ませ ん 。 劣化 な し の 圧縮 を サポ ー ト し ます 。 





sm Loader ク ラス の 主 な プロ パテ ィ 概 要 











ロー ド し た ファ イル を 参照 する | content load() メ ソ ッ ド で ロー ド さ れ た ファ イル 
:Disp1ayOb] ect の ルー ト 表 示 オ ブ プ ジ ェ クト を 参照 し ます 。 









ニーー ー ーー 






読み 込み 状況 を 提供 する Loader 
Info オ プ ジ ェ クト を 参照 する 


contentLoaderTnfFo | 読み 込ま れ て いる オブ ジェ クト に 対応 す 
: hoaderTnf1o る Loaderlnfo オ ブ プ ジ ェ クト を 返し ます 。 











ーー1 
ビッ トマ ッ プ を ロー ド し て 表示 する 


mm Loader ク ラス の 主 な メソ ッ ド 概要 


的 メソ ッ ド 名 メソ ッ ド の 概要 
() 


進行 中 の ロー ド 処 理 を | c1ose 現在 進行 中 の load() メ ソ ッ ド の 処理 を 
キャ ン セ ル す る : Yo1d キャ ン セ ル し ます 。 


ファ イル を 指定 し て 口 | 1oad request で 指定 し た ファ イル を ロー ド 
ー ド する (reqduegt : URLRequest , し ます 。 

Contex : IOadGrCOnEtex 上 = 
nu1] ) :Void () 

: Rectanqle 


ByteArray を 使用 し て | 1oadBytes () ByteArray オ ブ ジ ェクト に 保管 され て 
デー タ を ロー ド す る : Vo1d いる バイ ナリ デー タ か ら ロ ー ド し ます 。 
ロー ド さ れ た オブジェ | un1oad () load() メ ソ ッ ド を 使用 し て 読み 込ま れ 
クト を 削除 する : VO1d 


た オブ ジェ クト を 削除 し ます 。 
ロー ド さ れ た SWF を | un1oadandStop ( 


ロー ド さ れ た SWF フ ァイル を 削除 し 
削除 し て コマ ンド 実行 | gc : Boolean=true ) て 、 コ マン ド の 実行 を 中 止 し ます 。 
を 中 止 す る ・ YO1d 
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に 2 ココ 画 コ 疾 中 mp】 ヨ 蘭 -- -----------------ー-ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ビッ トマ ッ プ を ロー ド し て ステ ー ジ に 表示 する BitmapSampieA.fla 


1mport myPackage .B1tmapSamp1leClagsgsA: 
// ロ ー ド する イメ ー ジ ファ イル 
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ビ ピット マップ 

油 W . せ だ お も エエ よ nge "Ade8/ auUnme エ て TmaGe+ .G エ ドーーーーーーーーーーーーー デ ーーーー て ゆ 

// ク ラス イン スタ ンス の 生成 

var ob] : B1tmapSamp1eClassA = new BitmapSamp1eClassA (ur1 ) : 一 ーーーーーー ② 
PART / / 表 示 リ スト に 追加 

addChi1d( ob] ) :- 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー て ゆ 


この サン プル で は 、 ビ ッ ト マ ッ プ ファ イル 名 を 指定 し て BitmapSampleClassA ク ラス の イ 
ンス タン ス を 生成 し ます 。① で 指定 し た イメ ー ジ ファ イル を ②⑫ で BitmapSampleClassA ク フ 
ス の コン スト ラク タ に 渡し て ロー ド し ます 。 そ の 後 、③ で メイ ンタ イム ライ ン の 表示 リス ト に 
追加 し ます 。 


BitmapSampleClassA.as 


package myPackaqe { 
1mport fF]ash.display .B1tmap: 





1mport Fl]ash.d1splay .Loader : 
1mport Flash .displ]ay . SDr ユ 6e : 
1mport fF]ash.eVens .* : 


1mport Flash .net .URLReques : 


pub1ic cl]ass BitmapSampleClassA extendgs Sprite { 
/ / ロ ー ド する イメ ー ジ ファ イル 
D エ 1VatG Ya U エ 」] :S 上 了 1md : 
ナナ アコ に メス ルキ マフ クダ 
pub1ic funotion BitmapSamp1eC1agsgA (ur1 : String) 1 
上 18 . 1 エエ =u エ ] : 


doLoad ( ) : 


/ / 画 像 を ロー ド す る メソ ッ ド 


private fFunotion doLoad ( ) : vo1d { 


-@ 


var 1oader :Loader = new Loader ( ) : 

1oader . contentLoaderTnfo . addEventListener (Event .COMPLETE , 
completeHand1er) : 

NOMeh1 半 HG 
ERROR , 1oErrorHanQdler) : 

Var requegt : URLRequest=new URLRequegt (ur] ) : 

// イ メー ジ の ロー ド を 実行 

1oader . 1oad (reques 七 ) : 
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ビッ トマ ッ プ を ロー ド し て 表示 する 


// ロ ー ド 完了 時 の ルン ドラ メソ ッ ド 


private funotion completeHand1er (event : Event ) :Yo1d 1{ ⑥ 





Var loader : Loader=Loader (event . tardqet . 1oader) : 

/ /Bitmap オ ブ ジ ェクト と し て 処理 する 

Var 1maqe :B1tmap=1oader .Content ag Bitmap: 一 ーーーーーーーーーーーー⑦ 
/ / 表示 する 相対 座標 を 設定 


1mad@ .X=5 : 





(QO) 


1made .Y=5: - 
thisg .addChi1d( 1mage ): 
) 
Private funotion 1oErrorHand1er (event : TOErrorEvent ) :Yo1d { 
trace ("イメ ー ジ の ロー ド に 失敗 し まし た : 『 + ur1) 


⑯⑥ 





この サン ブル クラ ス は 、 ビ ッ ト マ ッ プ イメ ー ジ を Loader ク ラス を 使用 し て ロー ド し ます 。 ロ 
ー ド に 成功 し た ら 、 座 標 を 設定 し て 表示 リス ト に 追加 し ます 。 ロ ー ド する ファ イル は (④ の コン 
スト ラク タ の パラ メー タ で 受け 取り ます 。 コ ンス トラ クタ は url プ ロ パ ティ に ファ イル 名 を 設定 
し た ら 、 ロ ー ド を 行う doLoad() メ ソ ッ ド を 呼び 出し て ロー ド を 開始 し ます 。doLoad() メ ソ ッ 
ド の ⑤ で 、Loader オ ブ ジ ェクト に 対し て 、 ロ ー ド が 成功 し た と き と 和 失敗 し た と き の ハ ンド ラ を 
設定 し て いま す 。 成功 し た 場合 、⑥ から の ハン ドラ が 呼び 出さ れ ま す 。 そ の 中 で ビッ トマ ッ プ 
へ の 参照 を image 変 数 (⑦) に 代入 し 、⑧ で 座標 を 設定 し て 、⑧ で 表示 リス ト に 追加 し ます 。 
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ビッ トマ ッ プ の ロー ド 状 況 を 調べ る 





ActionScript で ビッ トマ ッ プ を サー ババ か ら ロ ー ド し て 表示 する 際 に 、 ロ ー ド の 進行 状況 を 取 
得 で きま す 。 進行 状況 は LoaderlInfo オ ブ ジ ェクト で 提供 され 、 読 み 込 むせ ファ イル の 総 バ イト 
数 、 読 み 込み 済み の バイ ト 数 や コン テン ツ の サイ ズ な ど が 取得 で きま す 。LoaderlInfo オ ブ ジ ェ 
クト を 取得 する に は 、 ロ ー ド を 実行 する Loader オ ブ ジ ェクト の contentLoaderInfo プ ロバ 
ティ を 使用 し ます 。LoaderInfo オ ブ ジ ェクト は 、 メ イン SWF が ロー ド さ れる と き に も 生成 さ 
れ ま す 。 メ イン SWF の LoaderInfo オ ブ ジ ェクト を 取得 する に は 、 表 示 オ ブ ジ ェクト クラ ス の 
loaderlnfo プ ロバ ティ を 使用 し ます 。 ロ ー ド の 進行 状況 は 、"progress" イ ベン ト の イベ ント 
オブ ジェ クト で ある 、ProgressEvent オ ブ ジ ェクト の プロ パテ ィ で 取得 で きま す 。 


和 m ProgressEvent ク ラス の 主 な プロ バテ ィ 概 要 














プロ パテ ィ 名 プロ パテ ィ の 概要 

















ロー ド 済 み サ イズ を 取得 する bytesLoaded ロー ド す る ファ イル の 読み 込み 済み バイ ト 数 を 
: Un 表し ます 。 
| | ] 
ロー ド す る ファ イル の サイ ズ を | bytesTota1 ロー ド す る ファ イル 全体 の 圧縮 後 の バ イト 数 を 
取得 する : un 表し ます 。 








m Loaderlnfo クラ ス の 主 な イベ ント 概要 






イベ ント の 概要 


















































ロー ド が 正常 に 終了 し た デー タ が 正常 に ロー ド さ れ た と き に 送出 され ます 。 
HTTP ス テー タス コー ド を 検出 | httpStatus | ロー ド 要 求 が HTTP で 行わ れ 、HTTP ス テー タス コ 
| ー ド を 検出 で きる 場合 に 送出 され ます 。 
ロー ド さ れ た SWF の プロ パテ ィ | nit ロー ド さ れ た SWF フ ァイル の プロ パテ ィ お よび メ 
と メソ ッ ド が 検出 可能 に な っ た ソ ッ ド が アク セス 可能 で 使用 で きる 状態 に な る と 送 
| | 出さ れ ま す 。 
| [ 還 | 
| ロー ド が 失敗 し た ] 1 OE エ エ の Or ロー ド 処 理 が 失敗 し た と き に 送出 され ます 。 | 
ロー ド を 開始 し た | pen ロー ド が 開始 され た と き に 送出 され ます 。 | 
「 [ _- - 
ロー ド の 進行 状況 を 受信 し た DrOdre88 ロー ド 処 理 中 に 状況 を 示す デー タ を 受信 し た と き に 
送出 され ます 。 

















ョ mLoaderlnfo ク ラス の 主 な プロ パテ ィ 概 要 





ロー ド 済 み サ イズ を 取得 する | bytesLoaded ロー ド す る ファ イル の 読み 込み 済み バイ ト 数 
: uint を 表し ます 。ProgressEvent ク ラス に も 同様 








の プロ パテ ィ が あり ます 。 
本 








時 一生 
ビッ トマ ッ プ の ロー ド 状 況 を 調 へ べ る 


皿 Loaderlnfo クラ ス の 主 な プロ バテ ィ 概 要 (続き ) 
敵 隊 2 ロリ ウィ も も | フロ リティ roWW 


ロー ド す る ファ イル の サイ ズ | bytesTota1 ロー ド す る ファ イル 全体 の 圧縮 後 の バ イト 数 = 寺 
を 取得 する 表し ます 。ProgressEvent ク ラス に も 同様 の 


プロ パテ ィ が あり ます 。 
読み 込ま れ た オブ ジェ クト を | content LoaderInfo オ ブ ジ ェクト に 関係 し た 読み 込ま 
参照 する : Disp1ayOb]ject 上 | れ た オブ ジェ クト を 参照 し ます 。 
読み 込ま れ た ファ イル の 幅 と | height 


読み 込ま れ た ファ イル の 規格 高 さ / 規 格 幅 を 青 
高 さ を 取得 する し ます 。 
FrameRate 読み 込み 済み の SWF フ ァイル に 関す る フレ ーー 
ー ト を 取得 する : Number ムレ ー ト を 取得 で きま す 。 
読み 込ん だ SWF の ファ イル 形 | swEVersion 読み 込み 済み の SWF フ ァイル の ファ イル 形 = 穫 
: un の バー ジョ ン を 取得 で きま す 。 











































= を 2 間 コ 疾 呈 mp】 コ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ーーー 


ビッ トマ ッ プ の ロー ド 開 始 / 進行 状況 を 調べ る BitmapSampleB-fla 
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8- 1 
ビッ トマ ッ プ 


// ク ラス イン スタ ンス の 生成 
Var の Ob] : B1tmapSampleClassB = new BitmapSamp1eClassB (ur1 ) : 
/ / 表 示 リ スト に 追加 

PART adQdCh11d( ob] ) 


馬 活 罰 の BitmapSampleA.fla と ほぼ 同じ で す 。 読み 込む イメ ー ジ ファ イル を 、 サ イズ が や 
や 大 きい も の に し て progress イ ベン ト を 多く 発生 させ て いま す 。 


BitmapSampietiassB.as 


package myPackage 1 


1mDOr ヒ 
1mDor 上 
1mDOr 
1mDOor 
1mDor 上 


0 1mDOr ヒ 


1mDOr 


Pub11C 


// ロ ー 


Flash.d1isplay .B1tmap : 
Flash.display . Loader : 

Flash .d1splay . SD エ + ユ 6 : 
Flash.even8 .*: 

Flash .net .URLRequeg: 
Flash.evens . HTTPStatusEVen : 


Flash .evens . PFOdreSSEVent : 


class BitmapSamp1eC1assB extends Sprite { 
ド す る イメ ー ジ ファ イル 


Dr1Va@ ar U 了 エ ] : S 上 了 ュ md : 
/ /Loader オ ブ ジ ェクト 変数 


Var 1oader : Loader : 


// コ ヨン シス ビラ タダ 
pub11ic function BitmapSamp1eC1assB (ur1 : String) {1 


th18 .u エ =U エ ] : 
doLoad ( ) : 


/ / 画像 を ロー ド す る メソ ッ ド 


private funotion doLoad ( ) :vo1d { 


1oader = new Loader ( ) : 
1oader . ContentTioaderTnfo . addEventListener (Event . COMPLETE , 


completeHand1er) : 


1oader . contentLioaderTnFo . ① 
addEventListener (TOE エ rorEVent . TO_ERROR , 1oErrorHand1er) : 


1oader . contentTLioaderTnFfo . 
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8-1ー ズ 
ビッ トマ ッ プ の ロー ド 状 況 を 調べ る 


addEventL1stener (HTTPStatusEvent .HTTP STATUS , 
httpStatusHand] er) : 

1oader .ContentLoaderTnfo . addEventLi1stener (Event . TNTT, 1nit 
HanQdler) : 

1oader .ContentLoaderTnfo . addEventListener (Event . OPEN, ODen ざ 
Handler) : 

1oader . ContenELoaderTnfo . addEventLi1 stener (ProgressEvent . 
PROGRESS , proqdressHand1er) : 

Var reQquegt : URLRequest=new URLRequegt (u エ 1 ) : 

/ / イ メー ジ の ロー ド を 実行 

1oader . 1oad (reques) : 


/ / 以 降 は ハン ドラ メソ ッ ド の 定義 
pr1vate funotion httpStatusHand1er (event : HTTPStatusEvent ) { 一 一 @ 
traCe ( "httpStatus を 受信 し まし た : HTTP ス テー タス コー ド : " + event . statug 
) : 
) 
Private funotion 1nitHand1er (event : Event) { 
traCe ( "1n1 モ イベ ント を 受信 し まし た " )。: 
) 
Pr1VaEe funoction openHand1er (event : Event) 1 
trace ( "open イ ベン ト を 受信 し まし た ) : 
) 
Private function progressHand]er (event : ProgresgEvent ) ( 
// ロ ー ド の 進行 状況 を 調べ る に は 、progress イ ベン ト ハ ンド ラ で 如 理 を 行い ます 。 
trace ( "progress イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : " + eyent . 
bytesLoaded + " / 総 バ イト 数 : " + event .bytesTota] + 
" >>LhoaderTnfo の 情報 :" + 1oader.contentLioaderTnfo .bytes 
Loaded + "リバ イト /" + 1oader.contentLoaderTnfo . bytesTota1 
+ "バイ ト 『) : 
) 
Private function comp1eteHand1er (event : Event ) :vo1d ( 
trace ("Complete イ ベン ト を 受信 し まし た : ファ イル の サイ ズ (heigqht=" + 1oader. 
he1qht + ", Width=" + 1oader.width + ")" ): 
//Bitmap オ ブ ジ ェクト と し て 処理 する 
var 1maqe :B1Emap=1oader .Conten as Bitmap: 
/ / 表 示す る 相対 座標 を 設定 


1made . メ =5 : 


1 
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8-1 
ビッ トマ ッ プ 


1mad@ .Y=5 : 
this .addChi1d( image ): 

) 

private funotion 1oErrorHand1er (event : TOE エ OrEVvent ) : Vo1d ( 
trace ( "イメ ー ジ の ロー ド に 失敗 し まし た : 『 + ur1): 


尾 王 罰 の BitmapSampleClassB.as に イベ ント 処理 を 追加 し た も の で す 。 イ ベン トバ ハン ドラ 
の 登録 は 、① で 行っ て いま す 。 ハ ンド ラ は ②⑫ 以 降 で す が 、completeHandler(0( で メッ セー ジ 
の 主力 と 、 フ ァイル の 縦横 サイ ズ の 取得 も 行っ て いま す 。 ioErrorHandler()) は 同じ も の で す 。 
③ の progressHandler() が ロー ド の 進行 状況 た 示す も の に な り ま す 。trace0) 関 数 で progress 
状況 を 出力 し て いま す 。 通常 は ProgressEvent イ ベン ト オ ブ ジェ クト の 情報 を 使用 し ます が 、 
バイ ト 数 を 示す Loaderlnfo オ ブ ジ ェクト の 同じ 情報 も 出力 し て いま す 。 ロ ー カ ル で 実行 し た 
結果 は 下記 の よう に な り ま す 。 


ぁ 実行 結果 出力 


open イ ベン ト を 受信 し まし た 

progre8s イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : 0 / 総 バ イト 数 : 200316 >>LoaderTnfO 
の 情報 : 0 バイ ト /200316 バ イト 

progresg8 イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : 65536 / 総 バ イト 数 : 200316 
>>LoaderTnfFo の 情報 :65536 バ イト /200316 バ イト 
progress8 イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : 131072 / 総 バ イト 数 : 200316 
>>LoaderTnfFo の 情報 :131072 バ イト /200316 バ イト 

progresg イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : 196608 / 総 バ イト 数 : 200316 
>>LoaderTnfo の 情報 :196608 バ イト /200316 バ イト 

progress イ ベン ト を 受信 し まし た : 受信 済み バイ ト 数 : 200316 / 総 バ イト 数 : 200316 
>>TioaderTnfo の 情報 :200316 バ イト /200316 バ イト 

ini モ イベ ント を 受信 し まし た 

httpStatug を 受信 し まし た : HTTP ス テー タス コー ド : 0 

comp1ete イ ベン ト を 受信 し まし た : ファ イル の サイ ズ (height=640, width=480) 


ライブ ラリ の イメ ー ジ を 表示 する 





Bitmap ク ラス は 画像 イメ ー ジ を 表示 オブ ジェ クト と し て 処理 する た め の ク ラス で す 。 そ の 
た め 、 イ メー ジテ データ の 処理 に 関し て は Bitmap ク ラス に は 下 表 に 示さ れる よう に 最小 限 の プ 
ロバ ティ し か あり ませ ん 。 ビ ッ ト マ ッ プ の ピク セル 処理 、 フ ィ ル ター の 適用 や 描画 を 行っ た り 、 
ライ ブラ リ に 格納 され た ビッ トマ ッ プ を ステ ー ジ 上 に ロー ド し た りす る 際 に は 、BitmapData 
クラ ス を 使用 する 必要 が あり ます 。 本 項目 で は 、 ラ イブ ラリ に 格納 され た ビッ トマ ッ プ イメ ー 


ジ を BitmapData オ ブ ジ ェクト に より ステ ー ジ 上 に 表示 する サン プル を 解説 し ます 。 こ の と き 、 


BitmapData オ ブ ジ ェクト で イメ ー ジ の デー タ を 作成 し 、 表 示す る た め に Bitmap オ ブ ジ ェ ク 
ト で ラッ プ す る 必要 が あり ます 。 


* き Bitmap ク ラス の 主 な プロ バテ ィ 概 要 。 












































ピク セル デー タ を 処理 する | bitmapDatsa Bitmap オ ブ ジ ェクト の ピク セル デー タ を 
た め の BitmapData オ プ ジ ェ | :fE1ash.disp1ay . 処理 する た め の BitmapData オ ブ ジ ェ ク 
クト を 参照 する B1tmapData ト に アク セス で きま す 。 

も っ と も 近い ピク セル に 吸 | pixe18napping | Bitmap オ ブ プ ジ ェ クト が も っ と も 近い ピク 
着 さ せる : 5 上 エエ 1ng セル に 吸着 され る か どう か を 指定 し ます 。 
拡大 縮小 時 に スム ー ジ ング | smoothing ビッ トマ ッ プ を 拡大 / 縮 小 す る と き に スム 
させ る : Boo] ean ー ジ ング する か どう か を 指定 し ます 。 











m Bitmap ク ラス の 主 な メソ ッ ド 概要 
メソ ッ ド 名 メソ ッ ド の 概要 





Bitmap オ ブ ジ ェクト | Bitmap コン スト ラク タ で す 。Bitmap オ 


を 作成 する bitmapData: = nu11 , ブ ジ ェクト を 新しく 作成 し ます 。 
p1xe1Snapp1ng : String = "auto", | bitmapData オ ブ ジ ェクト が す で 
SmoothinqgBool1ean = fa1]sgse に ある 場合 、 第 1 パラ メー タ で 指 

定 で きま す 。 








コー ド を 実行 する 間 に イ メー ジ を ライ ブラ リ に 格納 し て クラ ス 名 を 設定 する 必要 が あり ます 。 
下図 の よう に ライ ブラ リ で イメ ー ジ を 選択 し て プロ パテ ィ ダ イア ログ ボッ クス を 表示 し て 
1.1ActionScript 用 に 書き 出し 」 に チェ ッ ク を つけ 、2.「 ク ラス 」 名 を 記入 し ます 。 こ こ で は 、 
クラ ス 名 は 「WinterScene] と いう 名 称 に し て いま す 。OK を 押し て ダイ アロ グ を 閉じ る 際 に 
[ActionScript ク ラス に 関す る 警告 」 が 表示 され ます が 、 そ の まま OK を 押し て ダイ アロ グ を 閉 
じ ま す 。 
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ビッ トマ ッ プ 
ピッ トマ ッ プ プロ パテ ィ 

Winterlmage2.GIF し OK | 

て : 着 jsers 避 . 5 

Miyata\fPictures\winterImage2.GIF キャ ン セ ル 

1999 年 5 月 13 日 6:00:00 更新 (U) 

480 x 640 ピカ セル 8 ビッ トピ カセ ゼル ーー 

PART スム ー ジ ン が 9) 「 ー 

圧縮 (C) : | 劣化 な し (PNGGMF) * 2040D 





ロス レス : オリ ジ ナ ル = 307.2 引 , 圧 絶 徒 = 
180.3 kb, ポル ジ ナル 58% 


] 1. チ ェ ッ ク を つけ る 
ActionScript 用 に 書き 出し 


/ 1 フレ ー ム 目 に 書き 出し 


2 ラ 2( 〇 : WnterScene 2. ク ラス 名 を つけ る 
基本 カラ ス : Hash.display.BitmapData ッ 隊 二 細 ' EE 還 
、 AcHionScript クラ ス に 関す る 轄 和 
共有 | 
この の ラス の 定義 が り ラス (内 に 見 つか 5 な か っ た た め 、 定 
ラン タイ ム 共 有用 に 書き 出し (の ) 全 。 きき 出 け SC 5WF ファ イル 3 自 生生 成 れ ま す 。 


ッ テ ーー 


今後 、 表示 し な ( い D) 


に 


ご BtmapsampleCswf 
ファ イル (表示 滞 特 (CO デバ ッ ク D) 
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= 1 こう 
ライ ブラ リ の イメ ー ジ を 表示 する 


= を 1 コ 上 = 疾 mmp】 ヨ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


ライ ブラ リト に 格納 し た ビッ トマ ッ プ イメ ー ジ を ステ ー ジ に 表示 する BitmapSmpietjla 
/ / ラ イブ ラリ の イメ ー ジ イン スタ ンス を 格納 する BitmapData オ ブ ジ ェクト 変数 


var w1nEterSoeneDaa : B1tmapDaa : 

/ /BitmapData を 表示 する た め の Bitmap オ ブ ジ ェクト 変数 
var w1nEerSoeneD1 play : B1tmap: 

// ド ラッ グ ド ロ ッ プ を 行う た め の 8pr1ite オ ブ ジ ェクト 変数 
Var Conta1ner : SD エ r1G 

/ / 初期 処 理 を 行う 関 数 


Function ni () :vo1d 1 


/ / ビ ピット マッ プ を 表示 

ShowTmade ( ) : 

// ドラ ッ グ ドロ ッ プ の イベ ント リス ナー を 登録 

this . stage . adQEventL1stener (MouseEvent .MOUSE DOWN, startDraggind ): 
thig . stage . addEventListener (MouseEven .MOUSE UP, stopDraqgqgindgd ): 
// ス ムー ジン グ を ON/OFEF に する チェ ッ ク ボ ックス の イベ ント リス ナー 

smoothinqg Chk .addEventL1stener (Event .CHANGE , setSmoothingd ): 

// ビ ピット マッ プ を 拡大 する チェ ッ ク ボ ックス の イベ ント リス ナー 

8CaleUp chk.addEventListener (Event .CHANGE, scaleTmage ): 


/ / ラ イブ ラリ の イメ ー ジ を 表示 する 関数 


Function showTmaqe ( ) : vo1d { 一 一 ーーーーーーーーーー ① 


//winterScene と いう クラ ス 名 の ビッ トマ ッ プ を イン スタ ンス 化 

w1nterSoeneData=new w1nterSoene ( 0 , 0) : 一 一 ーーーーーーーーーーーーーーーーーーー ⑨② 
/ /BitmapData イ ンス タン ス か ら Bitmap オ ブ ジ ェクト を 作成 

winterSoceneD1splay=new B1tmap (WinterSceneData) : 

/ / コン テ ナ の 8prite オ ブ ジ ェクト 

conta1ner = new Sprite ( ) : 

/ /Bitmap オ ブ ジ ェクト を コン テ ナ に 格納 

container . addCh11d( winterSoceneDigp1ay ): 

Conta1ner . メ =5 : 

Conta1ner . =5 : 

/ / コ ン テ ナ を ステ ー ジ に 表示 

thig .addCh11dAt ( Containmer, 0  ) : 一 一 ーーーーーーーーーーーーーーーーーーーーーーー ③ 


/ /Bitmap オ ブ ジ ェクト の gmoothing を ON/OFF に する 関数 


Funotion setSmoothing (event : Event ) :vo1d { 


w1nterSoeneDi gplay . Smoothinq=event . tarqget . se1eoed : 
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// イ メー ジ の スケ ー ル を 拡大 / 縮小 する 関数 
Function sca1eTmage (event : Event ) :vo1d { 
if (event .target . selected) 1 
PART winterSceneD18play . 8Ca1e メ =6 . 3 
winterSceneD1sp1ay . SCaleY=6 . 3 : 
) e1se { 
winterSoeneD18play . SCale メ =1 . 0: 


winterSoeneD1gplay . SCaleY=1 . 0: 


) 
// コ ン テ ナ を ドラ ッ グ する 関数 
Funoction startDragging (event :MouseEvent ) :Yo1d { 
/ / チ ェ ッ クボ ックス 上 で マウ ス ダ ウ ン さ れ た 場合 、 ド ラッ グ し な い 
1F (event .target==this . scaleUp chk| | event .targdet==h1s . 


gmoothing chk) { 


1 業 GeGUTT 
) 


container . 8 も 上 artDrag ( ) : 


) 

// ドラ ッ グ を 停止 する 関数 

Funotion stopDragging (event : MouseEven ) : vo1d { 
/ / チ ェ ッ クボ ックス 上 で マウ ス ア ッ プ され た 場合 、 何 も し な い 
1f (event .tarqet== て this .scaleUp chk| | event .tarqdet==this . 
gmoothing chk) { 


GtuTT : 


) 


container . 8topDrad ( ) : 


) 
/ / 初 期 処理 関数 の 呼び 出し 


お も も も た : 


この サン プル で は 、 ラ イブ ラリ の ビッ トマ ッ プ イメ ー ジ を ステ ー ジ に 表示 し ます が 、Bit 
map ク ラス の smoothing プ ロ パ ティ の 効果 も 確認 し ます 。 そ の た め に ステ ー ジ 右上 に ビッ ト 
マッ プ を 拡大 する た め の チ ェ ッ クボ ックス と 、smoothing を オン に する チェ ッ ク ボ ックス を 配 
置 し て いま す 。 拡 大 し た ビッ トマ ッ プ の 見 える 位置 を 変え て smoothing 効 果 を 確認 で きる よう 
に 、 ド ラッ グ で きる よう に し て いま す 。 そ の た め 、container と いう Sprite オ ブ ジ ェクト を 作 
成 し て 、Bitmap オ ブ ジ ェクト を 格納 し て いま す 。① か ら の showlmage() 関 数 が ライ ブラ リ の 
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8- 1 -3 
ラフ イブ ラリ の イメ ー ジ を 表示 する 


ビッ トマ ッ プ を ステ ー ジ の 表示 リス ト に 追加 する 処理 を 行っ て いま す 。⑧⑫ で BitmapData イ ン 
スタ ンス を 作成 し て いま す が 、 引 数 の (0.0) は BitmapData コ ンス トラ クタ の パラ メー タ で 、 本 
来 は ビッ トマ ッ プ サイ ズ を 意味 し ます が 、 ラ イブ ラリ 読み 込み の 場合 は 無視 され る の で 、0 に 
し て いま す 。③⑬③ で this.addChildAt( container 0 ) と し て いる の は 、 ビ ッ ト マ ッ プ を チェ ッ 
クボ ックス の 背面 に 表示 する た めで す 。 実際 に は 、 ド ラッ グ 処 理 の た め の Sprite を 除い て 記述 
で きま す 。 も っ と も シン プル な 記述 は 次 の よう に な り ま す 。 


//winterScene と いう クラ ス 名 の ピッ トマ ッ プ を イン スタ ンス 化 
w1nterSceneData=new W1nterScene (0,0) : 

/ / BitmapData イ ンス タン スズ ス か ら Bitmap オ ブ ジ ェクト を 作成 
w1nterSoeneD1Splay=new B1tmap (winterSoeneData) : 
//Biamtp を ステ ー ジ に 表示 

this .addChi1d (winterSoeneDisplay  ): 


チェ ッ ク ボ ックス を クリ ッ ク す る と 、 イ メー ジ が 拡大 され ます が 、smoothing=false の 場合 1 





と true の 違い は 下記 の サン プル の よう に ギザ ギザ が スム ー ズ 化 さ れる こと で す 。 
咽 チェ ッ ク ボ ックス を クリ ッ ク し て 拡大 田 チ ェ ッ クボ ックス を クリ ッ ク し て 拡大 
(smoothing=false) (smoothing=true) 
| BitmapSampleC.swf に っ cl 隊 * ご BitmapSampleC.swW に keb| 屋 測 
ファ イル (F) 表示 (y) 刷 御 (CO デバ ッ グ (D) ファ イル (F) 表示 (y) 制御 ( 〇 O デバ ッ グ (D) 
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EE DEIE コ コウ 





BitmapData オ ブ ジ ェクト は 画像 イメ ー ジ の デー タ そ の も の を 表し 、 ビ クセ ルレ ベル の 負 理 
を 行う た め の メ ソ ッ ド が 用 意 さ れ て いま す 。 BitmapData オ ブ ジ ェクト は 個別 に イン スタ ンス 
を 生成 し て か ら 、 レ ンダ リン グ 用 に Bitmap オ ブ ジ ェクト に 割り 当て る こと も で きま すし 、 す 
で に Bitmap オ ブ ジ ェクト が ある 場合 、bitmapData プ ロバ パテ ィ で 参照 する こと が で きま す 。 
BitmapData ク ラス の プロ パテ ィ と 、 フ ィ ル ター、 塗 りや 描画 、 そ の 他 の メソ ッ ド は 主 に 下 表 
の も の が あり ます 。 BitmapData オ ブ ジ ェクト を 表示 する に は 、 度 誠人 置 で 解説 し た よう に 、 
Bitmap オ ブ ジ ェクト で ラッ プ す る 必要 が あり ます 。 サ ンプ ルコ ー ド で ピク セル の 取り 出し と 
設定 を 行っ て いま す 。 こ の 処理 を 行う メソ ッ ド の 詳細 を 下記 の 表 に 示し ます 。 


きき BitmapData クラ ス の 主 な プロ バテ ィ 概 要 
プロ パテ ィ 名 














プロ パテ ィ の 概要 


ビッ トマ ッ プ イメ ー ジ の 高 さ と 幅 ( ビ ピク セル 単 
位 ) を 表し ます 。 















| イメ ー ジ の サイ ズ を 調べ る 


























・ ユヒ 
イメ ー ジ を 表す 知 形 オブ | reci [読み 取り 専用 ] ビッ トマ ッ プ イメ ー ジ の サイ 
ジェ クト を 取得 する :Rectangle ズ と 位置 を 表す 息 形 オブ ジェ クト で す 。 
イメ ー ジ が 透明 度 を サポ ー | transpa [読み 取り 専用 ] ビッ トマ ッ プ イメ ー ジ が ピク 
ト す る か 調べ る | :Boo1ean セル 単位 の 透明 度 を サポ ー ト する か を 表し ます 。 











mm BitmapData ク ラス の 主 な メソ ッ ド 概要 (フィ ルター 関連 ) 


フィ ルター オブ ジェ ク | app1yFi1ten ソー スイ メー ジ に フィ ルター オブ 
ト を 適用 する SourCeB1tmapDaa : B1tmapDaa , ジェ クト で 定義 され た フィ ルター 
SourceReot : Rectanq1e, を 適用 し ます 。 


de8gt 上 Point : Po1n , 
F1i]ter : B1tmapF11Eer 
< 〇 1d 














applyFilter() メソ ッ ド | generateF1i1EterRect ソー ス 乱 形 と フィ ルタオ ブ ジ ェ ク 
に よっ て 影響 を 受け る | SourceRec : Rectang1e, ト を 指定 し て 、applyFilter() メ 
邊 形 を 調べ る F11Eer : B1tmapF11Eer ソ ッ ド 呼び 出し に よっ て 影響 を 受 


・Rectanq1e ける 息 形 を 調べ て 返し ます 。 














8-1-4 
BitmapData を 使う 


m BitmapData クラ ス の 主 な メソ ッ ド 概要 (塗り 、 描 画 関連 ) 


ビッ トマ ッ プ イメ ー ジ | draw( BitmapData オ ブ ジ ェクト 上 に 
上 に 描画 する SourCe : TB1tmapDrawaD1e , Source で 与え られ る 表示 オブ 
ma ヒエ ュ x : Ma モエ ix = nu]], ジェ クト を 描画 し ます 。 
ColorTransfForm : Co1orTransfForm 
ae 

bl endMode : S 上 rinqd = nu11 , 
C11pRect : Rectanqle = nu11 , 
8moothing :Boo1ean = fa]se 

) : Vo1d 





































Fi11Recot ( 
rec : Rectanqle , 
Co1 Or : u1n 

) : Yo1d 















知 形 領域 の ビク セル を 
塗り つぶ す 


rect で 指定 され た 領域 を color で 
示さ れる ARGB カ ラー で 塗り つ 
ぶ し ヒ < ッ 

















Fl]oodFi1] 1] ( 
汰 人 も 。 
3: 稚 も 。 
Coo : uin 
) : Vo1d 


塗り つぶ し 処理 を 行う (x, y) 座標 を 始点 と し て color で 


塗り つぶ し を 行い ます 。 



























no18e ( 
ranQdomSeed : in , 

上 OW:sU1nt = 0。 

high:u1n = 255, 
Channe1Opt1on8:u1nt = 7, 
raySCal1e : Boolean = fa]lse 
) :void 


ラン ダム ノイ ズ で 沙 り 
つぶ す 


パラ メー タ に より 指定 され る ラ 
ンダ ム ノ イズ を 表す ピク セル で 
イメ ー ジ を 塗り つぶ し ます 。 




















Perlin ア ル ゴ リ ズム で 
自然 に 見 える ラン ダム 
ノイ ズ を 適用 する 


perlinNoi ge ( 
baseX : Number , 
baseY : NumDer , 
numOctaVe8 : uint , 
randomSeed : 1n , 

8t ュ oh : Boo] ean , 
Fracta]Noi se : Boo1] ean , 
Channe1Opt1on8:uint = 7, 
qrayScale :Boolean = fal]se, 
offgset8g : Array = nu11 

) :Vo1d 







Perlin ノ イズ 生成 アル ゴリ ズム 
に よる ノイ ズ パ ター ン を ビッ ト 
マッ プ に 適用 し ます 。 




































ピク セル ディ ゾル ブ を 
実行 する 


p1xelDisso1Ve ( 
SOurCeB1tmapData : BitmapData , 
SOuFCeRect : Reotang1e, 

dest 上 Point : Pon , 
randOmSeed: 1n = 
numP1xe18:int = 0, 
Fil1CO1or:uint = 0O 
) : 1 


ソー スイ メー ジ か ら タ ー ゲ ッ ト 
イメ ー ジ へ の ピク セル ディ ゾル 
ブ 、 ま た は 同じ イメ ー ジ を 使用 
し た ピク セル ディ ゾル ブ を 実行 
し ます 。 






















1 ピク セル の カラ ー を 
設定 する 


Set 上 P1xe] ( 
SE 。 
ミユ 1 も , 
CO1Or : u1n ヒ 
) : VO1d 


BitmapData オ ブ ジ ェクト の 1 つ 
の ピク セル カラ ー を 設定 し ます 。 
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8- 1 
ビッ トマ ッ プ 


外 BitmapData クラ ス の 主 な メソ ッ ド 概要 ( 沙 り 、 描 画 関 連 )( 続 き ) 


1 ピク セル の カラ ー と | setPixe132 ( BitmapData オブ ジェ クト の 1] 
アル ファ を 設定 する Xx: in , つの ピク セル に カラ ー 値 と アル 
y : 1nt , ファ 透明 度 を 設定 し ます 。 
CO Or : u1n ヒ 
) :VO1d 




























征 BitmapData クラ ス の 主 な メソ ッ ド 概要 (その 他 ) 


ビッ トマ ッ プ の コピ | cl1one () :BitmapData BitmapData オ ブ ジ ェクト の 
ー を 作成 する クロ ー ン を 作成 し て 新しい オ 
ブ プ ジェ ウタ ト と し て 返し ます 。 





































ビッ トマ ッ プ の 一 部 
の コピ ー を 作成 する 


CopyPixe1g ( 
SOurCeB1tmapData : B1tmapDaa, 
SOurCeRect : Rectand1e , 
destPoirnt : Point , a1phaB1tmapDaa : 
BitmapData = nu11 , 
a1phaPoirnt : Pont = nul1, 
merqeAlpha : Booleari = falSe 

) :Vo1d 


soOurceBitmapData で 与え ら 
れる イメ ー ジ を destPoint で 
指定 され る 知 形 領域 に コピ ー 
し ます 。 











ビッ トマ ッ プ の メモ | dispose () :vo1d 


リ を 解放 する 


BitmapData オ ブ ジ ェクト に 
使用 され て いる メモ リ を 解放 
し ます 。 


指定 し た ポイ ント (x, y) の RG 
B ビ ピク セル 値 を 表す 整数 を 返 
し ます 。 






























特定 ポイ ント の RGB 
ピク セル 値 を 調べ る 


qetPixe」 ( 
2: ま も 。 
Y : 1n ヒ 
) :u1nt 



















特定 ポイ ント の ARG 
B ピ クセ ル 値 を 調べ 
る 


detP1xe132 ( 
沈 3 も / 
Y : 1n ヒ 
) :u1nt 


指定 し た ポイ ント ( ぶ , y) の ア 
ルフ ァ チ ャ ン ネ ル デ ー ク タ と RG 
B デ ー タ を 含む ARGB カ ラー 
値 を 返し ます 。 


rect で 指定 され る 知 形 領域 か 
ら バ イト 配列 を 生成 し ます 。 



















息 形 領域 か ら バ イト 
配列 を 作成 する 


etPixe]lg ( 
reCt : ReCtand1e 
) : ByLeArray 































バイ ト 配 列 の デー タ で 、 Bitm 
apData の 乱 形 領域 に ある ピ 
クセ ル を 塗り つぶ し ます 。 


ge 寺 Pixe1s ( 
rect : Reotand1e , 

1nputByteArray : By 上 GA エエ ay 
) : Vo1d 


バイ ト 配 列 を 乱 形 領 
域 の ピク セル デー タ 
に 変換 する 









hitTegt ( 
FirgstPoirt : Po , 
firstA]phaThresho1d : u1nt , 
geconQdOb] ect : Ob] ec , 
gecondB1tmapDataPoin : Po1rtt = 
secondA1phaThresho1d:uint = 1 
) : Bool1ean 


イメ ー ジ を スク ロー | scro11 (xint, yiint) :void (x。 y) で 指定 し た ピク セル 分 
ル す る イメ ー ジ を スク ロー ル し ます 。 

















他 の ビット マップ や 
オブ ジェ クト と の 接 
触 を 調べ る 


secondObject で 与え られ る 
ポイ ント 、 息 形 、 ま た は 他 の 
ビッ トマ ッ プ イメ ー ジ と ピク 
セル の ヒッ ト が ある か を 検出 








8-1-4 
BitmapData を 使う 


因 BitmapData クラ ス の ビク セル 取得 / セ ッ ト を 行う メソ ッ ド 詳細 


メソ ッ ド 名 メソ ッ ド の 詳細 




















qetPixe1 ( X, y で 指定 し た BitmapData オ ブ ジ ェクト 内 の ポイ ント の RGB ピ クセ ル 
x:1nt , 値 を 取得 し て 、 整 数 値 で 返し ます 。 ピ クセ ル 値 は アル ファ 情報 を 含ま な 
y : int いも の で 、 次 の フォ ー マ ッ ト で す (0x は 16 進 表記 を 表し ます )。 

) :uint 0x000000 て OxFFFFFF 





RGB カ ラー 情報 の 内 容 は 次 の と お り で す 。 
Ox00 00 00 
R G B 























getPixe132 ( X, y で 指定 し た BitmapData オ ブ ジ ェクト 内 の ポイ ント の ARGB ピ クセ ル 


x: 1nt , 値 を 取得 し て 、 整 数 値 で 返し ます 。ARGB ピ クセ ル 値 は アル ファ 情報 を 
y:1nt 含む も の で 、 次 の フォ ー マ ッ ト で す (Ox は 16 進 表記 を 表し ます )。 
) :uin 0x00000000 て 0xFFFFFFFF 





ARGB カ ラー 情報 の 内 容 は 次 の と お り で す 。 
Ox00 OO 00 00 
川 7 R GB 

















8etPixe] ( 
3 : う も 。 
7 セ 。 
CO1Or : u1n ヒ 
) :Vo1d 


X, y で 指定 し た BitmapData オ ブ ジ ェクト 内 の ポイ ント の ピク セル 値 を 
color で 指定 し た RGB 値 に し ます 。 

















8etP1xe132 ( 
3。 壮 折 も 。 
北本 も 。 
CoO1or) :VO1d 


X, y で 指定 し た BitmapData オ ブ ジ ェクト 内 の ポイ ント の ピク セル 値 を 
color で 指定 し た ARGB 値 に し ます 。 
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8- 1 
ビッ トマ ッ プ 


初期 状態 で は 、 各 ピク セル に ラン ダム な 値 を 持つ 300X300 の 正方 形 を 描画 し 、 タ イマ ー 処 


理 に より 、 ア ルフ ァ 値 を 減少 ざさ せ て フェ ー ド し ます 。 


ーー 


BitmapData に よる 図形 の 作成 と アル ファ 値 の 変更 


1mport fl]ash .d1isplay .B1tmaDp: 
1mport fF1]ash .d1isp1ay .B1tmapDaa: 


1mport Fl1ash .ut ュ 18 .T1me エ : 


/ /BitmapData オ ブ ジ ェクト 変数 
var bitmapData : B1tmapData: 
/ /Bitmap オ ブ ジ ェクト 変数 

Yar btmap : B1tmap: 

/ / 描 く 正 方 形 の 縦横 サイ ズ 

Var hw :1n キ =300: 

導 だ まま 。 よ お に すま も ) 

/ / ピ クセ ル デ ー タ の 格納 用 変数 
Va Dp1X :u1n : 

/ / ア ルフ ァ 値 の 格納 用 変数 

Ya a1D :U1n : 

// タ イマ ー オ ブ ジ ェクト 変数 


Ya mr :1mer : 


/ / 初 期 処 理 (正方 形 の B1tmapData を 作成 し て 表示 する ) 
Funotion init() 1{ 
/ / 正 方形 の B1tmapData を 作成 
bitmapData=new B1tmapData (hw , hw , 上 rue) : 
For (1 = 0: 1 <= hw: 1++) 人 { 
for (] = 0: ] <= hwz j++) { 
// ピ クセ ルカ ラー を ラン ダム な 値 に する 


BitmapSampleD.fla 


bitmapData . setPixe] ( 1, ], Math.random() * OxEFFFFEFE ): 


) 
/ / 表 示 用 の Bitmap オ ブ ジ ェクト を BitmapData オ ブ ジ ェクト か ら 作 成す る 


bitmap=new B1tmap (b1tmapData) : 
/ / 表 示 リ スト に Bitmap オ ブ ジ ェクト を 追加 
this .addChi1d( bitmap ): 

/ /〒imer オ ブ ジ ェクト と イベ ント リス ナー の 登録 


8-1-4 
BitmapData を 使う 


tmr=new Timer(10) : 
tmr .addEventListener (T1merEvent .TTMER, setFade) : 
tmr .addEventL1gsEener (T1merEvent .TTMER COMPLETE , enQdFade) : 


tmr . 8 上 ar ( ) : 


/ /T1imer イ ベン ト で 呼び 出さ れる リス ナー 
Funct1on setFade (event : Event ) :vo1d { 
For (1 = 0: 1 <= hwz 3 も ++) { 
for (] = 0: ] <= hw: ]++) { 

/ / ピ クセ ル の ARGB 値 を 取得 

p1x=bitmapData . getPixe132 (1 , ]) : 

// ア ルフ ァ 値 を 取り 出す 

alp = ( px & OxEF000000 ) >>> 24: 

// ア ルフ ァ 値 を - 1 

&」D -= 1: 

/ / ア ルフ ァ 値 が 0 に な っ た ら 終 了 す る 

if (a]p==0) { 
trace( 『 終 了 し まし た 。!『 ): 
Emr.d1spatohEvent ( new TimerEvent ( TimerEvent .TTMER COMPLETE 
こま ば 
reUuTT : 

) 

/ / 元 の ピク セル 値 と 新しい アル ファ 値 で 新しい ピク セル 値 を 作成 

pix = ( alp << 24 ) | ( pix & 0x00FFEFFFE ): 

/ /BitmapData オ ブ ジ ェクト に 設定 

bitmapData . setPixe132( 1, ], pix ): 


/ /T1mer イ ベン ト 処 理 を 終了 する 関数 
Funotion endFade (event : Event ) :void { 


tmr . removeEventL1 st 上 ener (T1merEvent .TTMER, setFade) : 


) 


/ / 初期 処理 の 呼び 出し 


ょ 3 を (6): 
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8-1 
ビッ トマ ッ プ 


BitmapData で 図形 を 作成 し て 表示 、 ピ クセ ル 処 理 を 行う サン プル で す 。① か ら の init() 関 数 
で BitmapData オ ブ ジ ェクト の 作成 と Bitmap オ ブ ジ ェクト に よる 表示 リス ト へ の 追加 を 行っ 
て いま す 。③⑧ で 行っ て いる 処理 は 、 作 成 し た 四角 形 の ピク セル を 1 つ す ずつ ラン ダム な 値 に し て 

PART いま す 。 実行 結果 イメ ー ジ に ある よう な 、1 ピ クセ ル ず つ 色 が 異な る ノイ ズ 風 の 塗り に な り ま す 。 
③ の 処理 は 、BitmapData オ ブ ジ ェクト を メイ ンタ イム ライ ン の 表示 リス ト に 追加 し て ステ ー 
ジ に 表示 する も の で す 。④ か ら の 関数 は Timer イ ベン ト で 呼び 出さ れる も の で す が 、 や は り 1 ビ 
クセ ル ご と の 処理 を 行っ て いま す 。⑤ で getPixel32() メ ソ ッ ド に より 、 ア ルフ ァ 値 を 訪 む ビク 
セル デー タ を 取得 し て いま す 。⑤ の 処理 は 、ARGB の 32 ビ ッ ト の うち 、 ア ルフ ァ 値 を 表す 上 位 
8 ビッ ト を 取得 する も の で す 。⑦ で 値 を -1 し ます 。 そ の 結果 、0 に な っ た 場合 、 処 理 を 終了 する 
た め に ③⑧ の 処理 を 行い 、Timer の キャ ン セ ル を 行う た め の TIMER_COMPLETE イ ベン ト の 送出 
を 行い ます 。③ で 元 の ピク セル 値 と 、 新 し い ア ルフ ァ 値 を 合わ せ て 新しい ビク セル 値 を 作成 し 
て BitmapData オ ブ ジ ェクト の 指定 し た ビ ピク セル 位置 に 適用 し ます 。 


タイ マー 終了 時 の メッ セー ジ 


隊 人 旬 終了 し まし た 。! 
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8-1-5 ピッ トマ ッ プ イメ ー ジ を コピ ビー する 





BitmapData ク ラス に は ビッ トマ ッ プ デー タ を 操作 する た め の メ ソ ッ ド が 用 意 さ れ て いま す 
が 、 ビ ピッ トマ ッ プ デー タ を コピ ー す る 場合 は clone() メ ソ ッ ド を 使用 し ます 。 こ の メソ ッ ド は 文 
子 通 り ク ロー ン を 作成 し て 返す も の で 、BitmapData 型 の 変数 に 戻り 値 を 代入 し て すぐ に コピ 
ー 元 と 同じ ビッ トマ ッ プ を 操作 で きま す 。 そ の 後 ビ ッ ト マ ッ プ に 描画 や フィ ルター を か ける 場 
合 、BitmapData ク ラス の メソ ッ ド を 使用 で きま す が 、 サ イズ や アル ファ 、 位 置 な どの 操作 は 
表示 オブ ジェ クト と 共通 の 処理 に な る た め 、Bitmap オ ブ ジ ェクト で ラッ プ し て か ら 処 理 を 行 
いま す 。 こ ちら の サン ブル で は 、 コ ピー し た ビッ トマ ッ プ の 大 き さ を アル ファ 、 位 置 を Bit 
map オ ブ ジ ェクト で 変更 し ます 。 


BitmapData ク ラス の コピ ー メ ソ ッ ド 詳細 



































ーー 
メソ ッ ド 名 | メソ ゾ ッ ド の 詳細 1 
現在 の BitmapData オ プ ジ ェ クト と 同じ 内 容 の 新しい オブ ジェ クト を 作成 し て 返し | ま 介 線 
| :B1tmapData ます 。 現在 オブ ジェ クト を セー ブ し て お き 、 編 集 す る 場合 な ど に も 使用 で きま す 。 | 














2 訓 前 紅 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


元 の イメ ー ジ 


プ BttmapSampleC sw IE <" 8 
ファ イル (E) 表示 (y) 制御 () デバ ッ ツ 65) (063 BOY 








| ン BitmapSempleE、swf “ [5 | 革 責 
ファ イル (FE) 表示 Cy) 屋 御 (CO デバ ッ グ (D) 

















まま 才 


0 が 
了 ン ー] pp の 広 J、 ] CC に 3 ・ で コ の 記 
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8- 1 
ッッ かぎ タプ 


弓 A 人 MPLE ビ ロ ロ ヒ 琴 EE 


BitmapData オブ ジェ クト の コピ ー を 多数 作成 する BitmapSampleE.fla 


/ / ラ イブ ラリ の イメ ー ジ イン スタ ンス を 格納 する BitmapData オ ブ ジ ェクト 変数 
var winterSoeneDaa : B1tmapDaa: 
/ /B1itmapData を 表示 する た め の Bitmap オ ブ ジ ェクト 変数 
var winterSceneD1isp1ay : B1tmaD : 
/ /BitmapData の クロ ー ン 格納 用 変数 
var で 1oneData : B1tmapData : 
/ / ク ロー ン 用 表示 オブ ジェ クト 
var で CloneDi gp : B1tmap: 
/ / 初期 処理 を 行 つ 関数 
Function init ( ) :vo1d { 
// ビ ピッ トマ ッ プ を 表示 
8howTmade () : 
) 
/ / ラ イブ ラリ の イメ ー ジ を 表示 する 関数 
Function showTmage ( ) :void { 
//winterScene と いう クラ ス 名 の ビッ トマ ッ プ を イン スタ ンス 化 
winterSoeneData=new WinterSocene (0,0) : ーーーーーーーーーー① ゆ ライ ブラ リ イ メ ー ジ の 表示 
/ /BitmapData イ ンス タン ス か ら Bitmap オ ブ ジ ェクト を 作成 
winterSoceneDisp1ay=new Bitmap (winterSceneData) : 一 ② ラ イフ ラリ イメ ー ジ の 表示 
this .addChi1qAt ( winterSoceneD1splay, 0 ): 
for ( var iz:imt = 1 ,: 1 <= 10 ,: i++) 1{ 
c1oneData = winterSceneData .C1one () : 
cl1oneDisp = new Bitmap( cloneData ): 
c1oneDisp .a1pha = Number( ( 10 - i ) / 20 ): 
cl1oneDisp.scaleX = Number( ( 10 - i ) / 10 ): 
cloneDisp.scaleY = Number( ( 10 - 1 ) / 10 ): 


c1oneDisp.x = ( stage .stageW1dth - cl1oneDisp .w1dth ) / 2: 
cl1oneDisp.y = ( stage .stageHeight - cl1oneDisp.height ) / 4: 
Cc1oneD1 gp . Smoothind = 上 FUG: 


addChi1d( cl1oneD18pD ): 


) 
③ 10 個 の クロ ー ン を 作成 。 違 い が わ か る よう に 
/ / 初 期 処理 関数 の 呼び 出し alpha、 scaleX、 scaleY の 位置 変更 
1n1 七 () : 


BitmapSampleC.fla で 使用 し た ライ ブラ リ 格 納 の イメ ー ジ を 再び 使用 し て 、 ク ロー ン を 多 


数 作成 する サン プル で す 。 


表示 オブ ジェ クト を 
ビッ トマ ッ プ イメ ー ジ 上 に 描画 する 





BitmapData ク ラス に は 、 ビ ッ ト マ ッ プ イメ ー ジ 上 に 、 指 定 し た 表示 オブ ジェ クト を 措 画 す 
る た め の draw(0 メ ソ ッ ド が あり ます 。 こ の メソ ッ ド の パラ メー タ に は 、 描 画す る 表示 オブ ジェ 
クト / ビ ピット マッ プ テ ー タ 以外 に 、 描 画 時 に 適用 する Matrix オ ブ ジ ェクト (ビッ トマ ッ プ の 変換 )、 
ColorTransform オ ブ ジ ェクト (ビッ トマ ッ プ の カラ ー 調 整 )、 ブ レン ドモ ー ド 、 描 画 領域 、 ス ム 
ー ジ ング を 指定 で きま す 。 つ まり 、 描 画す る オブ ジェ クト の マト リッ クス 操作 その 他 の アレ ン 
ジ が 行え ます 。 タ イム ライ ン で 編集 すれ ば た だ イン スタ ンス を 配置 し て プロ パテ ィ を 設定 する 
だ け で す が 、ActionScript で 動 的 に 描画 する た め に は 、 サン プル コー ド の よう な 処理 を 行い ます 。 











sm BitmapData クラ ス の コピ ー メ ソ ッ ド 詳細 























| メソ ッ ド 名 | メソ ッ ド の 詳細 | 
現在 の BitmapData オ ブ プ ジ ェ クト 上 に source で 指定 し た オブ ジェ クト | 1 
SOUTCG : を 抽 男 し ます 。 こ の パラ メー タ の 型 は IBitmapDrawable と な っ て いま 
TB1tmapDrawab1e , す が 、BitmapData と DisplayObject ク ラス が 実装 する イン タフ ェ ー ス | 
| matrix:Matrix = nu11, | で 、 パ ラメ ー タ に は この どちら か の オブ ジェ クト を 渡す こと が で きま す 。 
co1orTrangsform : matrix : 描 田 する source オ ブ プ ジ ェ クト の 位置 を 移動 、 拡 大 / 縮 小 、 回 転 、 
Co1orTramsform = 変換 する 場合 、 そ れ ら の 設定 を 行っ た Matrix オ ブ ジ ェクト を 指定 で きま す 。| 
nu1 1 , _ colorTransform : sourcCe オ プ ジ ェ クト の カラ ー を 調整 する た め の Co 
b]1 endMode : Strinq = lorTransform オ ブ ジ ェクト を 指定 で きま す 。 | 
nu1 1 , blendMode : flash.display.BlencMode ク ラス の 定数 値 を 指定 し て ブ | 
c]ipReot : Rectangle = レン ドモ ー ド を 適用 で きま す 。 | 
nu1 ] , clipRect : source の うち 、 描 画す る 領域 を Rectangle オ ブ ジ ェクト で | 
smoothing : Boo1ean = 指定 で きま す 。 指定 し な いと source オ ブ ジ ェクト 全体 が 描画 され ます 。 
False smoothing : true の 場合 、source オ ブ プ ジ ェ クト が BitmapData の 場合 、 
サイ ズ 変 更 や 回 転 時 の スム ー ジ ング を 行う こと が で きま す 。 

















= 上 訓 間 コ 紅 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ご BitrmapSermnpleF sw ym 
| ファ イル (F) 表示 W) 司 件 ( 〇 O デバ ッ グ (D) 


W クリ ッ ク し て 描画 後 


や BltmapSarmpleF sw 
ファ イル (PD 表示 (y) 避 舌 (の デバ ッ グ (D) 


ロ 


ル z7Y パ 725 
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8- 1 
ビッ トマ ッ プ 


AMPLE ビ ロ DE EEE 双 OEEEEEIIII 


BitmapData オブ ジェ クト 上 に ビッ トマ ッ プ と テキ スト フィ ー ル ド を 措 画 する BitmapSampleE』 


1mport Fl]ash.display .B1tmapData: 
1mport Fl]ash.d1splay .B1tmap: 
1mport Fl]ash.text .TextF1e1d: 
1mport Fl]ash .text . TextFOrma : 
1mport fF]ash .gdeom . Ma ヒエ ュ テ : 


import Fl]ash.display .BlenQdMode : 


/ / 背 景 の イメ ー ジ イン スタ ンス を 格納 する BitmapData オ ブ ジ ェクト 変数 
var winterSceneDaa : B1tmapDaa : 

/ /BitmapData を 表示 する た め の Bitmap オ ブ プ ジ ェ クト 変数 

var winterSoeneDigsplay : B1tmap : 

/ / 描 画す る イメ ー ジ イン スタ ンス を 格納 する BitmapData オ ブ ジ ェクト 変数 
var F1owerData : B1tmapDaa : 

/ / 描画 する テキ スト オブ ジェ クト 変数 

va textData : TextF1e1d: 

// テ キス ト オ ブ ジェ クト の フォ ー マ ッ ト 用 オブ ジェ クト 変数 

ar 上 ex 上 FOrma : TeGxEEFOrma : 

// マ トリ ックス オブ ジェ クト 変数 

Yar mtx1 :Ma ヒ エメ : 


Yar mtx2 :Ma キ 1X : 


/ / 初期 処 理 を 行う 関数 
Function nit() :void { 
// ビ ピット マ ッ プ を 表示 


showTmadqe ( ) : 


/ / ラ イブ ラリ の イメ ー ジ を 表示 する 関数 
Function showTmage ( ) :void { 
//WinterSnow と いう クラ ス 名 の ビッ トマ ッ プ を イン スタ ンス 化 
winterSoceneData=new WinterSnow (0,0): 
/ /BitmapData イ ンス タン ス か ら Bitmap オ ブ ジ ェクト を 作成 
winterSceneDisp1ay = new Bitmap (w1nterSceneDaa) : 
this .addChi1qdAt ( winterSoeneDisplay, 0 ): 
/ / マ ウス を クリ ッ ク し た と き に 描画 を 行い ます 。 
this . stage . addEventL1stener( MouseEvent .CLTCK, cl1icked )。: 


8-1-6 
表示 オブ ジェ クト を ビッ トマ ッ プ イメ ー ジ 上 に 描画 する 


// マ ウス の クリ ッ ク イ ベン トバ ンド ラ 
furmCtion C1ioked (event :MouseEven モ ) :vo1d {一 ーーーーーーーーーーーーーーーーー① 
/ / 描画 する BitmapData 


FlowerDa 上 a=new FlowerTmaqge (0, 0) 


⑯ 


mtx1 = new Mat エ ix() : 

/ / 位置 を (280 , 230 ) に 移動 

が 区 1 EAAB よ は も 6 ( 280。 230 ) , 一 一 ーーーーーーーーー デ ーーーーーーーーーーーーーーーー の 
//draw ( ) メソ ッ ド で 描画 

winterSceneData .draw( FlowerData, mtx1) : 

/ / 描画 する TextF1ie1d と TextFormat 

も の ED mw REW FexkW3@ よ 8() : 一 ーーーー ツ ーーーーーーーーー ア ーー テー デー ニー ここ の 
textData . autoS1ze=TextF1e1dAutoSize . LEET : 

textFormat = new TextFOormat ( ) : 一 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーー ⑤ 
textFormat . Fon = "Monotype Cors1Va" : 

textFormat .81ze = 30: 

textFormat . Color = OxFEFEFFF : 

textData .defau1tTextFormat = extEormat : 

textData . ex = "Merry 又 !ma8": 

mtx2 = new Matr1x() : 

//TextFie1d の 位置 を (20 , 14 ) に 移動 

mtx2 .translate( 20, 14 ): 

//TextFie1d を 失 画 


W は よね 1eYBCeneDa&Ea .GCAW( も eoxtDa も ta,。 mmE2 7ーーーーーーーーーーーーーーーーーーーーー@ 


/ / 初期 処理 関数 の 呼び 出し 


1n1t () : 


飼 回 の テー マ は BitmapData オ ブ ジ ェクト の メソ ッ ド に より 、 動 的 に 描画 を 行う こと な の で 、 
サン ブル で は 、 ス テー ジ を クリ ッ ク し た タイ ミン グ で 描画 を 行い ます 。 ① か ら の 関数 が 描画 を 
行う っ も の で す 。⑧ で 作成 し て いる BitmapData オ ブ ジ ェクト は ライ ブラ リ に 作成 し た ビッ ト 
マッ プイ メー ジ ク ラ ス で す 。③ の よう に Matrix オ ブ ジ ェクト を 作成 し て draw() メ ソ ッ ド に 渡 
すこ と で 位置 や スケ ー ル 、 回 転 な ども 適用 で きま す 。④ で 作成 し て いる TextField オ ブ ジ ェ ク 
ト は テキ スト を 描画 する た め の も の で す 。⑤ の よう に TextFormat オ ブ ジ ェクト に より 、 書 式 
を 設定 し て か ら 、⑧⑥ で 描画 を 行っ て いま す 。 





うる 


8 - 2 フィ ルター 
だ の リ シル ニレ アン オン っ う )4 の ik 
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シェ ー ダ ー ShaderFilter フィ ルター 処理 され る オブ ジェ クト に シェ ー ダ を 


表示 オプ ジェ クト に 適用 する 


flash.filters パ ッ ケ ー ジ の フィ ルター クラ ス オ ブ ジェ クト を 作成 し て 、DisplayObject ま た 
は BitmapData オ ブ ジ ェクト に フィ ルター を 適用 する こと が で きま す 。DisplayObject へ の 
フィ ルター の 適用 手順 は シン プル で す が 、 配 列 を 使用 し て フィ ルター オブ ジェ クト を 替 積 的 に 
適用 で きる こと と 、 オ ブ ジ ェクト に 直接 フィ ルター が 適用 され る こと が 特徴 的 な こと で す 。 
ActionScript3.0 で は 、 下 表 の よう な フィ ルター が 使用 可能 で す 。 


sm DisplayObject へ の フィ ルター 適用 手順 
処理 内 容 
] 適用 する すべ て の フィ ルター ー の イン スタ ンス を 作成 し 、 プ ロ パ ティ を 設定 する 。 














2 適用 先 の DisplayObject の filtersArray プ ロ パテ ィ の 値 を Array 型 変数 に 代入 し 、1 で 作成 し た 
フィ ルター イン スタ ンス を 格納 する 。 


ら DisplayObject オ ブ ジ ェクト の filters プ ロ パ ティ に 2 で 作成 し た Array オ プ ジ ェ クト を 再 設定 す 
る 。 適 用 後 、Array オ ブ ジ ェクト に 格納 され た フィ ルター が 累積 的 に 適用 され ます 。 





乱 ActionScript3.0 の フィ ルター 


フィ ルター クラ ス フィ ルター の 内 容 


BevelFilter 表示 オブ ジェ クト に べべ ベル 効果 を 追加 で きま す 。 に 














BlurFilter 表示 オブ ジェ クト に ぽか し 効果 を 適用 で きま す 。 〇 














カラ ー ColorMatrixFilter 入力 イメ ー ジ の 各 ピ クセ ル の RGBA カ ラー 値 と ア 
マト リッ クス ルフ ァ 値 に 4 x 5 マト リッ クス 変換 を 適用 する こと 
で 、 新 し い RGBA カ ラー 値 と アル ファ 値 か ら な る 結 


果 を 作成 で きま す 。 


ConvolutionFilter マト リッ クス 畳み 込み フィ ルター 効果 を 適用 で きま す 。 














置き 換え マッ プ | Displacement 指定 され た BitmapData オ ブ ジ ェクト (置き 換え マ 
MapFilter ッ プ イメ ー ジ と いい ます ) の ピク セル 値 を 使用 し て 、 
オブ ジェ クト の 置き 換え (変位 ) を 実行 し ます 。 








ドロ ッ プ シャ ドウ | DropShadowFilter | ドロ ッ プ シャ ドウ を 表示 オブ ジェ クト に 追加 し ます 。 








GlowFilter 表示 オブ ジェ クト に グロ ー 効 果 を 適用 で きま す 。 








GradientBevelFilter | オブ ジェ クト に グラ デー ショ ン ベ べ ベベル 効果 を 適用 
し 、 表 示 で きま す 。 


GradientGlowFilter | 表示 オブ ジェ クト に グラ デー ショ ング ロー 効果 を 
適用 で きま す 。 





実行 する こと に よっ て フィ ルター を 適用 し ます 。 











9 こ ズ メー1 
フィ ルター オブ ジェ クト を 作成 し て 表示 オブ ジェ クト に 適用 する 


Flash 列 の 〇 は 、Flash CS4/CS5 Professional の フィ ルター パネ ル で 設定 可能 な こと を 示し 
ます 。 〇 が つい て いな い フ ィ ル ター は ActionScript で の み 適 用 可能 な も の で す 。 


き DisplayObject ク ラス の フィ ルター 適用 の た め の プ ロ パ ティ 詳細 
プロ パティ の 詳細 


filters | 表示 オブ ジェ クト に 適用 する フィ ルター オブ ジェ クト が 格納 され た 配列 で す 。 適用 する 
: ね エエ aY フィ ルター が 1 つの 場合 も 配列 に 格納 する 必要 が あり ます 。 配列 に 2 つ 以 上 の フィ ルター 


オブ ジェ クト が 格納 され て いる 場合 、 配 列 の 先頭 か ら 順 に 格納 され た フィ ルター オブ 
ジェ クト が 累積 的 に 適用 され ます 。 フ ィ ル ター の 適用 を 無効 に する 場合 、 こ の プロ パ 
テイ に null 値 を 設定 し ます 。 








= 中 衣 画 ヨコ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


< ワレ 
_ ファ イル (5 





LLSLI 
OL 






デバ ッ 











※ 初 期 状態 


= 上 コ 首 呈 mp】 ヨ 蘭 ---- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


DisplayObject へ の フィ ルター の 追加 FiterSampleA.fla 


1mport Flash.d1spl1ay.*: 
1mport Flash .F1i]1ter8g .*: 
1mport flash.net .URLReques : 
1mport f] .contro1]s .CheckBox : 


//Loader イ ンス タン ス 変 数 

var 1maqgeLoader : LOader : 

// フィル ター イン スタ ンス 変数 

Var BeVe」] : Beve1F11ter : 

Var Bl]ur : BlurF11Eer : 

Var DrOpShadow : DropShadowF11Eter: 


Var Glow :GlLowF11ter : 


/ / 初 期 刀 理 関数 
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8-2 


フィ ルター 


function ni () :vod { 


PART 


// 


/ / ス テー ジ に 画像 を ロー ド し て 表示 
1maqeLioader = new Loader () : 
Yar ur] :String = "1maqes/samp1eTmage01 .GTF" : 


Va エ ur1Req:URLRequest = new URLRequegt (ur] ) : 


や) 


1mageLoader . 1oad (ur1Req) : 
1madeLioader.X = 16: 

1maqdeLioader .Y = 16: 

addChi1d (1mageLoader) : 

// フ ィ ル ター オブ ジェ クト の 作成 

Beve] = new Beve1lF11Eer () : 

B1ur = new BlurF11ter () : 

DropShadow = new DropShadowF11ter() : 
Glow = new GlowF11ter ( ) : 

// チ ェ ッ ク ボ ックス の イベ ント リス ナー の 価 録 
this .Beve1 chk.addEventListener (Event .CHANGE, getF1lter ): 
this.B1ur chk .addEventListener (Event .CHANGE, getF11ter ): 

this .DropShadow chk . addEventLigstener (Event .CHANGE, setF11Eer ): 
this .G1ow chk .addEventL1stener (Event .CHANGE, setF1lter ): 


フィ ルター を セッ ト す る ハン ドラ 関数 


NG も も On SG だ よ 上 EeeWe0E : 人 VeiE) xw0 ま 3 (ーーーーーーー フ EE OPRO 


) 


// フ ィ ル ター 配列 変数 に 既存 の 配列 値 を 代入 


Var newF1i1ter8 :Array = 1maqgeLoader .F11ter8 : 一 ーー 一 一 ーーーーーーーーーー 
if ( ( event.target as CheckBox ) .selected ) { 

// フ ィ ル ター 配列 に フィ ルター オブ ジェ クト を 追加 

newF11ter8 .Dpu8h( thig[ event .tarqget .1abe1 ]  ):-ー 一 ーーーーーーーー⑦ 


/ / チ ェ ッ クボ ックス を 変更 で き な い よう に する 
eVen .tarqet .enabled = fFalse: 


) 
/ / 表 示 オ ブ ジ ェクト に フィ ルター 配列 を 設定 


生還 NE 貞二 を お 全 す も の と は  :N あ WE 和 まま ポー ゴー ニーーーー ヤヤ ーー 


1n1 七 () : 


DisplayObject へ の フィ ルター 適用 手順 に 従っ て フィ ルター を 設定 する サン プル で す 。 適用 
先 の 画像 は ② で 、Loader オ ブ ジ ェクト を 使用 し て ファ イル シス テム か ら 読 み 込み ます 。 3 で 
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お ーーー1 
フィ ルター オブ ジェ クト を 作成 し て 表示 オブ ジェ クト に 適用 する 


フィ ルター オブ ジェ クト を 作成 し て いま す が 、 何 も 設定 を 行わ な いた め 、 適 用 され る フィ ル タ 
ー は デフ ォ ル ト 値 に よる も の に な り ま す 。④ で チェ ッ ク ボ ックス の イベ ント ハン ドラ を 設定 し 
て いま す が 、 実 際 に フィ ルター を 設定 する の が ⑤ か ら の ハン ドラ 関数 で す 。⑥ で 既存 の フィ ル 
ター 配列 を newFilters:Array 変 数 に 退避 し 、(⑦ で その 変数 に フィ ルター オブ ジェ クト を 追加 し 
て いま す 。 こ の 行 の this[ event.target.Ilabel ] と いう 記述 は 、 チ ェ ッ クボ ックス の ラベ ル に ①) 
で 宣言 し て いる フィ ルター 変数 と 同じ 名 前 が つけ られ て いる た め 、 そ れ を 利用 し て フィ ルター 
オブ ジェ クト を 参照 し て いま す 。⑧ で フィ ルター 配列 を 再度 設定 し て いま す が 、 こ れ で フィ ル 
ター が 適用 され ます 。 


時 DropShadowFilter を 追加 


に プ FilterSar SAMEEAM0000 の 2NI 
ファ イル (E) 表示 (V 天 特 (O デバ ッ 





一 BlurFilter を 追加 


上 プ | wc: uoono AE ーー ビー ー 時 
、 フ ァイル (F) 表示 (V) 居 伯 (CO デバ ッ グ (D) 





323 


PART 


324 


フィ ルター を BitmapData 
と アン キレ / ト に 適用 する 





葉色 剛 で 解説 し た よう に 、flash.filters パ ッ ケ ー ジ の フィ ルター クラ ス オ ブ ジェ クト を 作成 
し て 、DisplayObject ま た は BitmapData オ ブ ジ ェクト に フィ ルター を 適用 する こと が で きま 
す 。BitmapData オ ブ ジ ェクト に フィ ルター を 適用 する 場合 、 下 記 の よう に フィ ルター の 適用 
先 と 結果 が 別 オ ブ ジ ェクト に な る た め 、 元 の オブ ジェ クト は その まま の 状態 を 保てる こと と 、 
対象 の ビッ トマ ッ プ の 適用 範囲 を 指定 で きる の が 特徴 的 で す 。ActionScript3.0 で 使用 で きる 
フィ ルター に つい て は 、 前 節 を ご 覧 くだ さい 


き BitmapData へ の フィ ルター 適用 手順 
順番 | 処理 内 容 














適用 する フィ ルター の イン スタ ンス を 作成 し 、 プロ パテ ィ を 設 婦 定 する 。 





BitmapData オ ブ ジ ェクト の applyFilter0 メ ソ ッ ド の パラ メー タ に フィ ルター を 適用 する Bit | 
mapData オ ブ ジ ェクト (適用 先 ) と 1 で 作成 し た フィ ルター イン スタ ンス 、 適 用 範囲 な ど を 指定 
する 。 結果 は メソ ッ ド を 呼び 出し た オブ ジェ クト に 適用 され 、 適 用 先 の オブ ジェ クト は その ま 
ま 残 り ま す 。 












































ー ] 
累積 的 に フィ ルター を 適用 する に は 、 1 と 2 の 処理 を 繰り 返 し ます 。 

sm BitmapData クラ ス の フィ ルター 適用 の た め の メ ソ ッ ド 詳細 

メソ ッ ド 名 メソ ッ ド の 詳細 
| app1yFi1te sourceBitmapData : フィ ルター を 適用 する BitmapData オ ブ プ ジ ェ ク 
| sourceBitmapDaa : ト を 指定 し ます 。 

B1tmapDaa , sourceRect : sourceBitmapData オ ブ ジ ェクト 内 の フィ ルター を 適 

8 〇 いと FCeReCt : Rectanqd1e , 用 する 領域 を 指定 し ます 。 

degstPoint : Po , destPoint : sourceRect で 指定 し た 領域 の 左上 位置 を 現在 の Bitmap 

F ユ 1」er :B1tmaDpF1」Eer Data オ ブ ジ ェクト 内 の どの 位置 に 適用 する か を 指定 し ます 。 

: YO1d filter : 適用 する フィ ルター オブ ジェ クト で す 。 


メソ ッ ド に より 、sourceBitmapData で 指定 し た オブ ジェ クト に 、sou 
rceRect お よび fiter に よっ て フィ ルター を 適用 し た 結果 が 現在 の Bit 
mapData オ ブ ジ ェクト の dgestPoint を 基点 と する 位置 に 適用 され ます 。 















に の 4= 韻 = コ 間 攻 - - - -------------------------- 








ニアン = 韻 コ 関 mmm】 コ 蘭 ーー-------- 


BitmapData オブ ジェ クト に フィ ルター を 適用 する FilterSampleB.fla 


1mport fFlash .d1isp]ay.*: 
1mport Flagsh .F1]1terg .*: 
1mpor Flash .net .URLRequegat : 
1mport fF] .Contro1 sg .CheockBox : 


/ / Loader イ ンス タン ス 変 数 

Var 1maqeLioader : Loader : 

// フ ィ ル ター イン スタ ンス 変数 

Var Beve」 : BevelF11ter: 

Var BI1ur:B1urF1]er: 

Var DroDpShadow : DropShadowF ュ 1 1ter 了 : 


Var Glow :G1owEF ュ 1 上 er : 





8-2-2 
フィ ルター を BitmapData オブ ジェ クト に 適用 する 






DropShadow を 適用 








、 ファ イル (F) 表示 (V) 品 御 (CO デバ ッ グ (D) 
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8- 2 


フィ ルル ター 


// 


app1yF11ter( ) メソ ッ ド で 使用 する パラ メー タ 用 変数 


1mport Fl]asgh .qeom . Rectand1e: 


1mport flagh .qeom . Po1nt : 


// 


適用 先 の B1tmapData 


Var arqet : B1tmapDaa : 


// 


BitmapData 表 示 用 B1tmap 


ゞ ar 上 ardetB ュ tmap : B1tmaDp : 


// 


初期 処理 関数 


Function nit () :void { 


/ / ス テー ジ に 画像 を ロー ド し て 表示 

1mageLoader = new Loader () : 

Va u] :Strind = "1maqe8/ 8ampletmage01 .GITF": 

Yar ur1Req:URLRequest = new URLRequegt (u エ 1 ) : 
1mageLoader . 1oad (ur1Req) : 

1madeLoader.X = 16: 

1madeLioader .Y = 16: 

addChi1d (1mageLioader) : 

// フ ィ ル ター オブ ジェ クト の 作成 

Beve] = new Beve]1F11 て er() : 

Bl]ur = new BlurF11ter() : 

DropShadow = new DropShadowF11ter() : 

G1ow = new GlowF11Eter () : 

ルル チエ ツク ポッ ツ ス の イベ ント ルン ドラ 

this .Beve] ohk .addEventL1stener (Event .CHANGE, setF11ter ): 
this.B1ur ohk .addEventLiistener (Event .CHANGE, setF11ter ): 

this .DropShadow chk .addEventLi1istener (Event .CHANGE, setF11Eter ): 
this.G1ow chk .addEventListener (Event .CHANGE, setF11Eer ): 

/ / 適 用 先 の BitmapData オ ブ ジ ェクト を 作成 

tarqget = new BitmapData( 140, 140, true, OxFEFFFEFFEFE ): 
targetBitmap = new Bitmap( targqet ): 

tarqetB1tmap.X = 170: 
tarqdetBitmap .Y = 11: 

/ /Bitmap オ ブ ジ ェクト を 表示 リス ト に 追加 
addChi1qd( tarqgetBitmap ): 


/ / フ ィ ル ター を 適用 する ハン ドラ 関数 


Function setF11ter(event : Event ) : ざ O1d { 一 ーーーーーーーーーーーーーーーーーーーーーー ②) 


8-2-2 
フィ ルター を BitmapData オ ブ ジ ェクト に 適用 する 


/ / 前 回 の フィ ルター 効果 を クリ ア す る た め に 乱 形 を 塗り つぶ す 
tarqdet .F1i11Rec( new Rectangle( 0, 0, 140, 140 ) , OxFFFFFFFF 2 
if ( ( event.target as CheckBox ) .se1ected ) { ③ 
// フ ィ ル ター の 適用 
target . app1yF11ter( ( 1mageLoader .content as Bitmap ). 
b1tmapData, new Rectangle( 0, 0, 128, 128 ) , new Point( 5, 5 ), 
thig[ event .tarqget .1abe] ] ): 
/ / チ ェ ッ クボ ックス を 変更 で き な い よう に する ④ 


eVernt .t 上 arqde . enabled = fa]gse: 


3 を も ま ) ) 


屋 誠 剛 の FilterSampleA.fla を 流用 し て 、 フ ィ ル ター を 適用 する 個所 を 変更 し て いま す 。 こ 
の サン ブル で は 、 積 的 な フィ ルター の 適用 は 行わ ず に 、 毎 回 新た に 適用 し て いま す 。 
BitmapData オ ブ ジ ェクト を 使用 する 場合 、 適 用 元 、 適 用 先 の 2 オブ ジェ クト を 利用 する こと 
に な り ま す 。 ま すず 適用 元 の 画像 は 、 民 受 生 較 と 同じ よう に Loader オ ブ ジ ェクト で ロー ド し ます 。 
適用 先 の オブ ジェ クト は 、① で 表示 リス ト へ の 追加 まで 行っ て いま す 。⑧ か ら の seetFilter() 関 
健 で BitmapData オ ブ ジ ェクト へ の フィ ルター の 適用 を 行っ て いま す 。③ で fillRect() メ ソ ッ ド 
を 実行 し て いる の は 、 前 回 の フィ ルター 適用 後 の 画像 が あっ た 場合 、 ク リア する た めで す 。④ 
で applyFilter(0 メ ソ ッ ド を 使用 し て お り 、 適 用 元 の 画像 の サイ ズ は 128x 128 で す が 、140※ 
140 の サイ ズ を と っ て いま す 。 こ れ は 、 フ ィ ル ター 適用 後に 、 そ の 効果 に よっ て 画像 の サイ ズ 
が 大 きく な る こと が ある か ら で す 。 
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8 - 3 グラ フィ ッ ク 描 画 
グラ フィ ッ ク 描 画 API を 使う 





ActionScript で 直線 、 曲 線 、 乱 形 、 円 、 塗 り 、 グ ラ デ ー シ ョ ン な どの グラ フィ ッ ク 図 形 描画 
を 行う に は 、Graphics ク ラス を 使用 し ます 。Shape、Sprite、MovieClip ク ラス の イン スタ 
ンス 上 に 描画 する こと が で きま す 。 こ れ ら の クラ ス に は graphics と いう プロ バテ ィ が 用 意 さ れ 
て お り 、Graphics オ ブ ジ ェクト を 生成 する 必要 は な く 、 こ の プロ バテ ィ を 通し て Graphics オ 
ブ ジ ェクト を 利用 で きま す 。 つ まり 、「 描 画 対 象 オ ブ ジ ェクト .qgraphics.Graphicvs ク ラス メソ ッ 
ド () 」 と いう 呼び 出し を 行っ て 描画 処理 を 行う こと が で きま す 。 描画 を 開始 する 前 に 、 色 や 塗 
りな どの スタ イル を 決定 する メソ ッ ド を 呼び 出し て お く 必 要 が あり ます 。 グ ラフ ィ ッ ク 措 画 を 
行う 場合 、Shape、Sprite、MovieClip の どの クラ スイ ンス タン ス を 使用 する か に つい て は 、 
下記 の 表 「Graphics ク ラス に よる 描画 対象 の クラ ス 」 を 参考 に し て くだ さい 。 サ ンプ ブ ルコ ー ド 
で は 、 も っ と も 手軽 に 円 や 四角 形 を 描画 する こと が で きる 、 シ ェ イ ブ ゴ 描 画 メ ソ ッ ド を 使用 し ま 
す 。 シ ェ イ ブ 描 画 メ ソ ッ ド は ビル トイ ン メ ソ ッ ド と も 呼ば れ 、 下 表 「Graphicxs ク ラス の 主 な 手 
画 メ ソ ッ ド 概要 (シェ イブ 描画 )」 の も の が あり ます 。 


和 m Graphics ク ラス に よる 描画 対象 の クラ ス 



























Shape | も っ と も 処理 効率 良く ActionScript に よる 描画 が 行え る イン スタ ンス に な り ま す 。 た 
だ し 、DisplayObjectContainer を 継承 し て いな いた め 、 子 を 持つ こと が で きま せん 。 
Shape オ ブ ジ ェクト は 描画 を 行う た め の キ ャ ン パ ス と いう こと も で きま す 。 
Sprite 子 を 持つ こと が で きる オブ ジェ クト と し て 、 描 画 も 行え を ます 。 タ イム ライ ン の 操作 を 
抽 必要 と し な い 場 合 に 使用 し ます 。 
MovieClip 子 を 持つ こと が で きる オブ ジェ クト と し て 、 描 画 も 行え を ます 。 タ イム ライ ン の 操作 を 
必要 と する 場合 に 使用 し ます 。 

















乱 Graphics ク ラス の 主 な 描画 メソ ッ ド 概要 (シェ イブ 描画 ) 








メソ ッ ド 名 メソ ッ ド の 概要 

円 を 描画 する drawC1rc1e | (x, y) 座標 を 中 心 、radius を 半径 (ビク セ 
x : Number , | ル ) と する 円 を 描画 し ます 。 
Y : NumDber , 
rad1u8 : NumDer 
) : び O1d 

椿 円 を 描画 する drawE111DSe (x, y) 座標 を 境界 ボッ クス の 左上 、width 
X : NumDer , と height を 幅 と 高 さ と する 本 円 を 描画 し 
y : Number , ます 。 


w1qdh : NumDer , 
he1gqht : NumDer 
) : ざ O1d 














8-3- 1 
グラ フィ ッ ク 措 画 AP| を 使う 


き Graphics ク ラス の 主 な 描画 メソ ッ ド 概 要 (シェ イブ 描画 ) 


メソ ッ ド 名 メソ ッ ド の 概要 


息 形 を 描画 する drawReot ( (x, y) 座標 を 左上 、width と height を 幅 と 
x : Number , 高 さ と する 短 形 を 描画 し ます 。 

Y : NumDer , 
w1qdth : Number , 
he1qht : Number 
) :Yo1d 






































角 丸 の 息 形 を 描画 
する 


drawROoundReot ( 
メ : NumDer , 

Y : NumDer , 
w1dh : Number , 
he1qht : Number , 
e111pseW1dEh : Number, 
el11pseHe1qht : Number = NaN 
) :Vo1d 


(x, y) 座標 を 左上 、width と height を 幅 と 
高 さ 、ellipseWidth、ellipseHeight を コ 
ー ナ ー に 適用 する 本 円 の 幅 と 高 さ と する 
角 丸 邊 形 を 描画 し ます 。 










符 Graphics ク ラス の 主 な 描画 メソ ッ ド 概要 (塗り と 線 ス タイ ル ) 


ビッ トマ ッ プ デー | beginBitmapFi11 ( 

タタ で 塗り つぶ す bitmap : B1tmapData , 
matr1x : Ma ヒエ ュ X = nu11, 
reDpea : Boolean = rue, 
8mooth : Boolean = fa]se 
) : Vo1d 


メソ ッ ド の 概要 


描画 領域 を ビッ トマ ッ プ イメ 
ー ジ で 塗り つぶ し まま 。 



































描画 する 色 を 指定 
する 


beginFi11 ( 
CO1Or : u1n , 
alpha :Numbper = 1.0 
) :VO1d 


lineTo() や drawCircle() な ど を 
行う 前 に 、 塗 り の 色 を 指定 し 
ます 。 


























beq1nGradientFi1 1 ( 
tyDe : S 上 1md , 
CO1O エ 8 : AA エエ aY ツ , 
a1Dpha8 : A エ エ ay , 

ra ヒ 1O8 : ム エ エ a ツ , 

ma 上 ヒエ 1xX : Ma ヒエ 1 エ 文 = nu]1], 
SpreadMethod : Strinqd = "pad", 
1nterpolat1onMethod : Strinqg = "rgb", 
Foca1PointRat1o :Number = 0 

) : VO1d 


グラ デー ショ ン 浴 
り を 指定 する 


Graphics オ ブ ジ ェクト の 後 
続 の 呼び 出し に 使用 する グ 
ラ デ ー シ ョ ン 塗 り を 指定 し 
ます 。 
















シェ ー ダ 塗り を 指 
定 す る 







beg1nShaderFi] ] ( 
8hader : Shader , 

ma キュ x : Ma ヒエ ュ x = nu]1 
) :Yo1d 








Graphics オ ブ ジ ェクト の 後 
続 の 呼び 出し に 使用 する シェ 
ー ダ 塗り を 指定 し ます 。 







塗り と 線 の スタ イ 
ル を クリ ア す る 


clear ( ) : ゞ o1d 









Graphics オ ブ ジ ェクト に 描画 
され て いる グラ フィ ッ ク を ク 
リア し て 塗り と 線 の スタ イル 
設定 を リセ ッ ト し ます 。 
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8-3 
グラ フィ ッ ク 描 画 


に BDDee クラ ス の 主 な 描画 メソ ッ ド 概要 ( 当 り と 線 ス タイ ル ) (続き) 


メソ ッ ド 名 


1 1neGradientStyle ( 
ELyDe : St 上 r1nd , 
CO1O エ 8 : A ム エエ aY , 
a1pha8 : A エ エ aY , 

て a ヒ 1O8 : ム エ エ a ツ , 
mat 了 1 := muU」1, 


SpreadMethod : S 上 rind = "pad" , 
1nterpo1ationMethod : S 上 1nd 
Foca1PointRat1o:Number = 0O 
: VO1d 


) 


線 の スタ イル を 指 
定 する 


1ineStyle ( 
thickneg88 :NumDer = NaN, 


GOLGYsU3n も = 0。 
a1pha :Number = 1.0, 


pixe1H1ninqg:Boolean = fFal18e, 
scaleMode : St エエ ind = "normal", 


cap8 : St 上 rinqd = nu1]1, 
joints : St 上 rinqd = nu1l1, 
mitterL1m1 :NumDer = 3 
) : Vo1d 


急 Graphics に を ーーー 


ST 
曲線 を 描画 


ビッ トマ ッ プ を 使用 し 
て 線 を 描く 


線 を 描画 する 
描画 位置 を 指定 する 


CurVeTo ( 
Con キ Oo1X : NumDer , 
Contro1 Y : NumDber , 
anChorX : NumDeTr , 
anChorY : NumDer 

) : Yo1d 


11neB1tmapSt 上 yle ( 
bitmap : B1tmapDaa , 

mat エ 1x : Ma ヒエ 1 = null1, 
reDpeat : BoOolean = 巧 UG , 
8mooth: Boolean = falgse 
) : Vo1d 


1 ineTo ( 
メ : NuUmDer , 
Y : NumDer 
) : YOo1d 


moveTo ( 
メ : NumDer , 
Y : NumDber 
) : VO1d 


メソ ッ ド の 概要 


線 の 描画 で 使用 する グラ デー 
ショ ン を 指定 し ます 。 


ll rdD 山 , 


lineTo0 メ ソ ッ ド や drawCirc 
le() メ ソ ッ ド な ど 、Graphics 
の メソ ッ ド の 後続 の 呼び 出 
し に 使用 する 線 ス タイ ル を 
指定 し ます 。 


メソ ッ ド 概要 (直線 と 曲線 の 描画 ) 


メソ ッ ド の 概要 


現在 の 描画 位置 か ら (anchorX, an 
chorY) ま で 、(controlX, control 
Y) で 指定 され た コン トロ ー ル ポイ 
ント を 使用 し て 曲線 を 描画 し ます 。 


線 と し て 使用 する ビッ トマ ッ プ を 
指定 し ます 。 


現在 の 描画 位置 か ら (x, y) まで 、 
現在 の 線 の スタ イル を 使用 し て 線 
を 描画 し ます 。 その後 で 、 現 在 の 
描画 位置 は (x, y) に 設定 され ます 。 


描画 位置 を (x, y) に 移動 し ます 。 





8-3- 1 
グラ フィ ッ ク 描 画 API を 使う 


OGA ac を CSS OSCARKSS に OS 2 7 1 ェ つ っ | 5) 人 語 
OS SSASSSSSS が SSSSESSESS ーー ここ OOE ES ペッ 
ほ デバ ッ グ (D) 


GraphicsSame 





ら ベ 
いあ 





= た 2 肖 = 者 四 mp】 コ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


Graphics クラ ス に よる シェ イプ の 描画 GraphicsSampleA_fla 
1mport Flash.display .Shape : 


/ / 描画 を 行う た め の 8hape オ ブ ジ ェクト 変数 
Var CamDu8 : ShaDG : 
/ / 円 の サイ ズ を 表す 変数 


Var CiroleSize : u1n : 


/ / ラ ンダ ム な 円 を 描く 関数 
Eunction draw8hapes() :vo1d { 一 一 ーーーーーーーーーーーーーーーーーーーーーーー① 
EOF (Va は:nE = 1 1 <= 300, も ま ++) 
_ //Shape オ ブ ジ ェクト を 作成 
Campu8 = new Shape ( ) : 
/ / ス テー ジ の 高 さ /14 を 最大 と する サイ ズ を ラン ダム に 決定 
C1roleS1ze =Math . random ( ) *this . stage . stageHe1ight /14 : 一 ーーーーーーー ② 
/ / 線 を 1 ピク セル 黒 に 設定 
Canu8 .9raPh1Cg.11ne8tyle( 1, Ox000000 ) : 一 一 ーーーーーーーーーーー③ 
/ / 円 を 描く 


Campus .draph1ocs .drawCircle(0, 0, oiroc1eSize) : 
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drawCircle() メ ソ ッ ド を 使用 する サン プル で す 。 か ら の ルー プ で 300 個 の 円 を 描画 し ます 。 
⑧ で ステ ー ジ サイ ズ を も と に し て circle の サイ ズ を ラン ダム に 求め て 3③ で 描画 し ます 。④ で 
Shape の 位置 を ステ ー ジ 内 で ラン ダム に 配置 する こと に よ り 結果 イメ ー ジ の よう な 描画 が 行わ 
れ ま す 。⑤ で 行っ て いる よう に 、 描 画 を 行っ た Shape オ ブ ジ ェクト は addChilde0 メ ソ ッ ド で 
表示 リス ト に 追加 する 必要 が あり ます 。 
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線 と 準 り を 定義 する 





葉 ※ 員 剛 の サン プル コー ド で は 、 黒 一 色 で 描画 し まし た が 、 実際 に は 好み の 線 と 塗り を 設定 し 
て か ら 押 画 を 行い ます 。 グラフィック API 描 画 時 の 手順 は 下記 「 グ ラフ ィ ッ ク API に よる 描画 手 
順 ] の と お り で す 。 特徴 と し て 、 一 度 指定 し た 線 と 塗り の 設定 は 保持 され る た め 、 線 と 塗り を 
変更 する 場合 は 5 番 に ある よう に 再 設定 を 行い ます が 、 そ う で な い 場 合 は 同じ 設定 で 複数 の 描 
画 を 継続 的 に 行う こと が で きま す 。 こ こ で は 、 単 色 の 線 と 塗り に つい て 解説 し ます 。 グ ラ デ ー 
ショ ン に よる 線 と 塗り に つい て は 、 攻 革 罰 「 グラデ ーション の 描画 を 行う ] を ご 覧 くだ さい 


邊 グラ フィ ッ フ API に よる 措 画 手順 
順番 | 処理 内 容 











] graphics プ ロ パ ティ を 持つ Shape、Sprite、MovieClip オ ブ ジ ェクト を 作成 する 

















2 線 と 塗り を 定義 する | 

3 | 描画 画す る 位置 を 決め る ーー | 
| 4 | 画 API に よる 措 画 | を 行う 
| 9 


別 の 線 と 和沙 り で 提 画す る 場合 、 現 在 の 塗り を 終了 し て 再 設定 を 行う 




































































き Graphics ク ラス の 単色 に よる 線 と 塗り 設定 の た め の メ ソ ッ ド 詳細 


メソ ッ ド 名 メソ ッ ド の 詳細 


beginF111 ( color : 描画 メソ ッ ッ ド に 対す る 今 後 の 呼 び 出 し に 使用 する 一 色 塗 り を 指 
co1or : un , 定 し ます 。 

alpha:Numbper = 1.0 alpha : アル ファ 透明 度 を 指定 し ます 。 指 定 し な い 場 合 、1.0 (透明 度 な 
し ) で す 。 

beginF 員 0、beginBitmapFil()、beginGradientFil() を 次 に 呼び 出す ま 
で 、 そ の 一 失 う は 継続 し ます 。 

















・ ざ 〇 1d 













| 





Graphics オ ブ ジ ェ ク ト に 描画 され て いる グラ フィ 2 を グリ アル 。 塗り 
| と 線 の スタ イル の メ 定 を リセ ッ ト し ます 。 | 




















endFil] () :vYo1d beginF 員 ()、 beginGradientFl(、 beginBitiaDFIO メ ゾ ソ ゾ ッ ド に よっ て | 
設定 され た 塗り を それ まで の 描画 オブ ジェ クト に 適用 し ます 。 例 えば 描 
画 し た 線 が 閉じ られ て いな い 場 合 、 こ の メソ ッ ド に より パス を 閉じ て 塗 
り が 行わ れ ま す 。 
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PART 
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8-3 
グラ フィ ッ ク 描 画 


L 3 クラ ス の 単色 に よる 線 と 塗り 設定 の た と め の メ ソ ッ ee mm 





| メソ ッ ド の 詳細 2 | | 
11neStyle( 線 ス タイ ル を 指定 し ます 。 drawRect() な どの シェ イブ 描画 メソ ッ ド や 
thioknesgs : Number = lineTo() な どの 線 描画 メソ ッ ド で 使用 する 線 に 適用 され ます 。 
NaN, 再び この メソ ッ ド や IineBitmapStyle()、IlineGradientStyle(0 メ ソ ッ ド を 
co1or:uint = 0, 呼び 出す まで 設定 が 継続 され ます 。 


a1pha :Number = 1.0, | thickness : 線 の 太 さ を 0 て 255 の ポイ ント 単位 で 指定 し ます 。 0 は デフ 
pixe1Hinting:Boo1ean | オル ト 値 で 、 極 細線 に な り ま す 。 


= fa]ge, color : 線 の 色 を 16 進 数 で 指定 し ます 。 

scaleMode : S 上 1nd = alpha : 線 の アル ファ 値 を 0ー1 の 範囲 で 指定 し ます 。 

"norma1" , pixelHinting : true の 場合 、 線 の ピク セル ヒン ティ ング を 行い ます 。 

caps : String = nu11, | scaleMode : 描画 オブ ジェ クト が 拡大 / 縮 小 し た と き の 線 の 太 さ の 拡大 

Jo1ntg : Strimd = / 縮 小 を 決め る モー ド で す 。 

nu] ] , LineScaleMode.NORMAL : オブ ジェ クト の 拡大 / 縮 小 と と も に 線 の 太 

miterL1m1 : NumDer = さも 拡大 / 縮 小 し ます 。 

3 LineScaleMode.NONE : 線 の 太 さ は 拡大 / 縮 小 し ませ ん 。 

) :vo1d LineScaleMode.VERTICAL/LineScaleMode.HORIZONTAL : 描画 オ 
ブ ジ ェクト を 垂直 / 水 平方 身 の み に 拡 大 / 縮 小 する 場合 、 線 の 太 さ を 拡大 
/ 縮 小 し ませ ん 。 


caps : 線 の 終端 の 形状 (キャ ッ プ ) を 指定 し ます 。 
CapsStyle.NONE : キャ ッ プ を 描画 し ませ ん 。 
CapsStyle.ROUND : 丸い キャ ッ プ を 使用 し ます 。 
CapsStyle.SQUARE : 四角 い キ ャ ッ プ を 使用 し ます 。 


NONE ROUND SQUARE 





joints : 三角 形 の 頂点 の よう な 角 を 描く と き の 形 状 を 指定 し ます 。 
JointStyle.MITER : マイ ター 形状 を 描画 し ます 。 
JointStyle.ROUND : 丸 角 の 形状 を 描画 し ます 。 
JointStyle.BEVEL : べ ベ ル の 形状 を 描画 し ます 。 


。 MITER ROUND _BEVEL 





miterLimit : jointStyle=JointStyle.MITER の と き 、 マ イタ ー が 切り 取 
られ る 限度 を 1 て 255 の 範囲 で 指定 し ます 。 
下図 は マイ ター が 切り 取ら れ た イメ ー ジ で す 。 





8-3-2 
線 と 準 り を 定義 する 


香 Graphics ク ラス の 単色 に よる 線 と 塗り 設定 の た め の メ ソ ッ ド 詳細 (続き ) 


メソ ッ ド 名 メソ ッ ド の 詳細 


マイ ター が 切り 取ら れる 、 コ ー ナ ー の 最大 角度 は 下 表 の と お り で す 。 最 
大 角度 以下 の 場合 、 切 り 取 られ る こと に な り ま す 。 









た ント ーー 
シーン こ で ON ここ ご に OTTO アー デー こ TOR に ト 
和 - に マ 。 ra で 3 we だ て ' 」 
Ye ンー で いぶ で が なこ ェ ト 、 
sa に ここ _- _ に こ o の っ 
ーー・ い 1 の いこ 20 に OS 
2 つ の PS 5 と TE な 
ー - に ) 
K 
。 閥 





= が 2 画 = 疾 mmlp】 ヨ 蘭 --- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


線 と 塗り を 変化 させ て 描画 する GraphicsSampleB.Hla 
1mport Fl1ash.disp1ay . Shape : 


/ / 描画 を 行う た め の Shape オ ブ ジ ェクト 変数 
Ya Campu8 : ShaDe : 

/ / 背景 色 の 最大 値 

Var PbqJCo1or : u1nt=0x65CCFF : 

/ / 円 の サイ ズ 

Var C1ro1e81ze :u1n : 


/ / ボ ー ダ 色 の 最大 値 
う 335 


PART 


336 


8-3 
グラ フィ ッ ク 描 画 


Ya borderCo1or : u1n 七 =0xaaaaaa 
/ / ボ ー ダ サイ ズ の 最大 値 


Var borderS1ze :u1n ヒ =1 .3: 


/ / ラ ンダ ム な 円 を 描く 関数 
Function drawShapes ( ) :vo1d { 
For (var :int = 1: 1 <= 300: i++) { 

Campu8 = new Shape ( ) : 
/ / ス テー ジ の 高 さ /14 を 最大 と する サイ ズ を ラン ダム に 決定 
circleSize=Math . random ( ) *this . stage . StageHe1qgh/14 : 
/ / 塗り の 色 を 指定 し て 、 ア ルフ ァ を ラン ダム に 決定 
campu8 .draphics .beg1nF11 1 (bdColor, Math .random 
( ) ) : 一 ーーーーーーーーーーーーーーーーーーーーー ーー ① 
/ / ボ ー ダ の サイ ズ と アル ファ を ラン ダム に 決定 


campu8s .draphics . 1 ineSty1e (Math . random ( ) *borderS1 ze , DOrderCO1Or , 





幸 き も れ 、FeWERG66) ) テーーーーーーー ョ ーッ = 
/ / 円 を 描く 

campu8 .draphios .drawC1irole(0, 0, CroleS1ze) : 

campu8 . draph1Cg . endF111 () : 

// シ ェ イ プ の 位置 を ラン ダム に 決定 

campus . x=Math . random ( ) *thi s . stage . StadeW1Qdth : 

campu8s .Y=Math . random ( ) *thi s . stage . SLadeHe1qdh : 

/ / 表 示 リ スト に 追加 

addChi1d (campu8 ) : 


drawShapeSs ( ) : 


尾 玉 語 剛 の GraphicsSampleB.fla サ ンプ ル に 修正 を 加え て 線 と 色 を ある 範囲 内 で ラン ダム に 
変化 させ る よう に し て いま す 。① の beginFil() メ ソ ッ ド の 第 2 パラ メー タ で alpha 値 を ラン ダ 
ム に 指定 し て いま す 。Math.random() メ ソ ッ ド は 0.0 一 1.0 の 範囲 で 値 を 返す た め 、 そ の まま 
ahpha 値 に 使用 し て いま す 。② の lineStyle()( メ ソ ッ ド で は 、thickness を 最大 1.3 ポ イン ト 、 
alpha 値 を 同様 に Math.random() で 設定 し 、 上 記 の イメ ー ジ を 描画 し て いま す 。 


線 と 曲線 を 描画 する 





ActionScript で は 、 描 画 の 基本 と な る 線 や 曲線 を 描く メソ ッ ド が 提供 され ます 。draw 
Circle()、drawRect() な どの シェ イブ 描画 メソ ッ ド も これ ら の 基本 メソ ッ ド を 利用 し て 知 形 や 
円 を 描き ます 。 指 画す る と き は 必ず | 現在 の 位置 」 を 基準 に し て 線 を 描き ます 。 単 純 に 現在 の 位 
置 を 移動 ご せる た め に moveTo() と いう メソ ッ ド が 用 意 さ れ て いま す 。 曲線 を 描く 場合 、2 つ の 
アン カー ポイ ント と 1 つの コン トロ ー ル ポイ ント で 構成 され る 二 次 ベ ジェ 曲線 に よる 描画 を 行 
いま す 。 線 や 曲線 を 描画 する 手順 は 下 表 の と お り で す 。 


線 や 曲線 の 基本 推 画 手 ー ー 
上 | 処理 










































































] dBhICS プ ロ パ テ ィ を 持つ Shape、Sprite、 MovieClip オ プ ジ ェ クト を 作成 する _ 
| 2 | 弱 と 塗り を 定義 する ーー _ 4 
| 3 | moveTo0 メ ソ ッ ド で 描画 の 基点 を 設定 する 
4 | line To()、curve To() に よる 直線 、 曲 線 の 描画 を 行う 
5 | 別 の 線 と 塗り で 描画 する 場合 、 現在 の 塗り を 終了 し て 再 設定 を 行う | 














き Graphics ク ラス の 線 と 塗り 設定 の た め の メ ソ ッ ド 詳細 
メソ ッ ド 名 メソ ッ ド の 詳細 


















moveTo 描画 位置 を (x. y) に 移動 し ます 。 こ の 位置 か ら curveTo()、lineTo() を 実行 し 
x : NumDer , て 曲線 、 直 線 を 描画 し ます 。 


・ ぴ 1 ピロ | 
] 











urVeT 描画 位置 か ら (controlX, controlY) の コン トロ ー ル ポイ ント を 使用 し て 、 ア 
conEro1X :Number, | ンカ ー ポ ボ ポイ ント (anchorX, anchorY) まで 曲線 を 描画 し ます 。 

Con 七 了 O1Y : NumDer , 

anchorX : NumDer, コン トロ ー ル ボイン ト (controIX, controlY) 





anChOrY : NumDer 


: マ 〇 1 ピロ 




















アン カー アン カー 
ボ ポイ ント ボ ポイ ント 
| (基点 ) (anchorX, anchorY) 
1 1neTc 描画 位置 か ら (x, y) まで 、 線 を 描画 し ます 。 描画 後 現在 の 描画 位置 は (x, y) に 
X : NumDer , な り ま す 。 
Y : NumDer 
・V 〇 1 ピ d X1, VZ 







3 ロロ e TO (2, y〆 ぢ / 


| 2|ne To 1. y2) 
UmOve TO CX, y/ 


mr 


X, V X2, V2) 
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ーー 
ュ ぐ 

craphicsSampieC.swf 
NKK 


三間 コ 蘭 | - --- -----------------------ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
32208 SS 


で は 


に k 

SIRENSS 

| N、 | や SS bo 

| KW wwy 
0 に ws 、 こ 

| 」 | ee 
本 YA、 へ 


PART 


EL 


「 MP 


9 - ゅ マー 
太っ 

$ 和 0\ パ 
ニャ 


。 


lineTo() で 様々 な 色 と 太 さ の 直線 を 描画 


pp ス ブン ご こ ・ Oi 反 
の 。 
る リ 
馬 ーー 


IN。 


「 Ns ( 
時 1 Pe に 1 / 、 
JJ で < に 
こ ー ーー 。 
wa e 


リ 


= が 1 下痢 計 mp】 ヨ 蘭 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


線 と 曲線 の 描画 GraphicSampleC.fla 
1mpor Flash.d1splay .ShaDpe : 
/ / 描画 を 行う た め の 8Shape オ ブ ジ ェクト 変数 
Var Campu8 : ShaD6e : 
/ / 線 色 の 最大 値 
var 1ineCo1or : u1n 上 =0xBBBBBB : 
/ / 線 の 太 さ の 最大 値 
Yar 1ineTh1iokne88 : u1n ヒ =4 : 
/ / ラ ンダ ム な 線 を 描く 関数 
Function drawShapes ( ) : vo1d { 
Campu8 = new Shape () : 
campu8 .draphics .moveTo( 0, 0 ): Se rs 
For (var 1i:inE = 1: 1 <= 1000: 1++) 1 の 太 さ と 色 を ラン ダム に 設定 
/ / 太 さと 色 を ラン ダム に 設定 
campus .draphiocs .11neStyle( Math .random ( ) *11ineTh1ockne88 , 
Math . random ( ) *]1neColor ): 
/ / ス テー ジ の 高 さ /14 を 最大 と する サイ ズ を ラン ダム に 決定 
campus .draphios .11ineTo( Math .random ( ) *thi gs . stage . StadeW1Qdth , 





③ 長 さ (終点 ) を ラン ダム に 設定 


Math . random ( ) *this . stage . StageHe1qht ): 
) 
/ / 表 示 リ スト に 追加 
addChi1d (campu8) : 


) 


drawShape8 ( ) : 
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線 と 塗り は 単色 だ け で な く グ ラ デ ー 








の カラ ー バ ネル 

ン ] [し 線 状 2 デー ント < 
本 | m-: 四 | 国 皿 
世 陳 ロリ ー ア ReB 

〇 Hi:0* 
〇 OS5:n% 


〇 Bin 沈 
⑨R:0 





| 
| 
| 
「 
| 





づき 全 ー 
パ 4 〇 Bi:n 
[00000 | Ai i00% ゴ 





sm Graphics ク ラス の グラ デー 
メソ ッ ド 名 


Ded1nGraQ1enF 
tyDe : S 上 エ ュ nd , 
CO1OT8 : A エ エ aYy , 
a1Dpha8 : Ar エエ ay , 
ra 革 1O8 : A エ エ 8Y , 
matrix : Ma ヒエ 1 = mu], 
SpreadMethod : St 上 r1nqd = "pad" , 
1nterpoat1onMethod : S 上 1nd = 

| rgb" , 

foca1Po1ntRat1o :Number = 0O 

) :VO1d 








ショ ン 


ショ ン で 行う こと が で きま す 。 下 表 に ある よう に 、 線 の 
グラ デー ショ ン を 設定 する に は 、lineGradientStyle()0 メ ソ ッ ド 、 塗 り の グラ デー ショ ン は 
beginGradientFill() メ ソ ッ ド で 行い ます 。 こ れ ら の メソ ッ ド の バラ メー タ は 多い で す が 、 パ 
ラメ ー タ の 設定 値 は オー サリ ング ツー ル の 「 カ ラー」 パネ ル と 対応 し て いる 部 分 が 多く 、 そ ちら 
を 参考 に する と 理解 が 深まり ます 。 


グラ デー ショ ン の タイ プ 
線 / 塗 り の 選択 


カラ ー 値 (16 進数 ) 


アル ファ 値 


カラ ー 値 と 色 の 分 布 比率 


線 と 和沙 り 設 定 の た め の メ ソ ッ ド 詳細 
メソ ッ ド の 詳細 


line To()、curveTo()、drawCircle() を は じ め と する シェ イプ 
描画 メソ ッ ド の 塗り で 使用 する グラ デー ショ ン を 指定 し ます 。| 
設定 は 次 に 再び この メソ ッ ド や beginFil()、beginBitmap 
Fl()、beginShaderFil() な どの 浴 り 設定 メソ ッ ド を 呼び 出す | 
まで 保持 され ます 。 

type : 描画 メソ ッ ド に 対す る 今後 の 呼び 出し に 使用 する グラ 
デー ショ ン 沙 り の タイ プ を 指定 し ます 。 
GradientType.LINEAR : 線 状 パ ス に ブレ ンド する グラ デー 
ンション 








線 状 ヴ ラ デ ーション 
放射 状 ヴ ラ デ ー シ ョ ン 
ビッ トマ ッ プ の 塗り 
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PART 
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逢 Graphics ク ラス の グラ デー ショ ン 線 と 塗り 設定 の た め の メ ソ ッ ド 詳細 (続き ) 


メソ ッ ド 名 


11neGradientStyl]e ( 

YDG : 

CO1OT8 : AA エエ aY ツ , 

a1pha8 : A エ エ aY , 

a ヒ 1O8 : AA エエ a ツ , 

ma ヒエ ュ 1x : Ma ヒエ 1 エ 文 = nu], 
SpreadMethod : St 上 rinqd = "pad", 
1nterpola 上 1onMehod : St 上 r1nd = 
PGIDY 。 
Foca1PointRa ヒ 1o:Number = 0O 

) : び O1d 















メソ ッ ド の 詳細 


colors : グラ デー ショ ン で 使用 する 色 を 最大 15 色 まで 配列 で 
指定 し ます 。 

alphas : colors 配 列 の 色 と 対 応 す る アル ファ 値 を 配列 で 指定 
し ます 。 

ratios : colors 配 列 の 色 の 分 布 比率 を 配列 で 指定 し ます 。0 
を 左端 、255 を 右端 と する 位置 を 使用 し て 、colors/alphas 
で 設定 し た それ ぞ れ の 色 と ア ルフ ァ 値 の 相対 位置 を 表し ます 。 
下図 は colors、alphas、ratios の サン プル 値 を Flash の カラ ー 
パネ ル の 一 部 を 引用 し て 表し た も の で す 。 














ratiOs: 0 180 255 








OxFF0000 OxOOFFO0 OxOOOQFF 
alpha:0.75 alpha:1.0 alpha:0.72 








Colors=[OxFF0000,.0x00FF00,.0x0000FFI: 
alphas=[0.75,1.0.0.721: 
ratios=[0.180,2551: 






matrix : グラ デー ショ ン 用 の Matrix オ ブ ジ ェクト を 作成 し て 
適用 で きま す 。flash.geom.Matrix ク ラス の createGradient 
Box() メ ソ ッ ド で 作成 し た 変換 マト リッ クス を 指定 で きま す 。 
グラ デー ショ ン 塗 り の 幅 と 高 さ は 描画 オブ ジェ クト で は な く 
この パラ メー タ で 指定 し た Matrix オ ブ ジ ェクト が 持つ グラ デ 
ーション マト リッ クス の 幅 と 高 さ で 決ま り ま す 。 
spreadMethod : グラ デー ショ ン の パタ ー ン を 決定 する spr 
ead メ ソ ッ ド を 指定 で きま す 。SpreadMethod ク ラス に PAD、 
REFLECT、 REPEAT の 3 種類 の 定数 が 用 意 さ れ て いま す 。 
interpolationMethod : グラ デー ショ ン を レン ダリ ング す 
る と き に 使用 する RGB ス ペー ス を 決定 し ます 。 
InterpolationMethod.LINEAR_RGB (線形 RGB 補 間 メ ソ ッ ド 
を 使用 )、InterpolationMethod.RGB (RGB 補 間 メ ソ ッ ド を 
使用 : デフ ォ ル ト ) を 選択 で きま す 。 

focalPointRatio : グラ デー ショ ン の 焦点 を 制御 する 数 値 を 
ー| ーー 1 の 範囲 で 指定 し ます 。 


line To()、curve To()、drawCircle() を は じ め と する シェ イプ 
描画 メソ ッ ド の 線 で 使用 する グラ デー ショ ン を 指定 し ます 。 
設定 は 次 に 再び この メソ ッ ド や IlineStyle() な どの メソ ッ ド を 
呼び 出す まで 保持 され ます 。 描画 の 前 に lineStyle() メ ソ ッ ド 
を 使用 し て スト ロー ク の 幅 も 指定 し て お く 必 要 が あり ます 。 
type : 描画 メソ ッ ド に 対す る 今後 の 呼び 出し に 使用 する グラ 
デー ショ ン 塗 り の タイ プ を 指定 し ます 。 
GradientType.LINEAR、GradientType.RADIAL を 指定 で き 
まま っ 
























8 
グラ テー ショ ン の 描画 を 行う 


き Graphics ク ラス の グラ デー ショ ン 線 と 塗り 設定 の た め の メ ソ ッ ド 詳細 (続き ) 


メソ ッ ド 名 メソ ッ ド の 詳細 


colors : グラ デー ショ ン で 使用 する 色 を 最大 15 色 まで 配列 で 
指定 し ます 。 

alphas : colors 配 列 の 色 と 対 応 す る アル ファ 値 を 配列 で 指定 
し ます 。 

ratios : colors 配 列 の 色 の 分 布 比率 を 配列 で 指定 し ます 。0 
を 左端 、255 を 右端 と する 位置 を 使用 し て 、colors/alphas 
で 設定 し た それ ぞ れ の 色 と ア ルフ ァ 値 の 相対 位置 を 表し ます 。 

















ratios: 0 






OxFFO000 Qx0OFF00 0OxOOOOFF 
alpha:0.75 alpha:1.0 alpha:0.72 










Colors=[O0xFF0000.0x00FF00,.0x0000FF: 
alphas=[0.75,1.0.0.72]: 
ratios=[0,180,255]: 













matrix : グラ デー ショ ン 用 の Matrix オ ブ ジ ェクト を 作成 し て 
適用 で きま す 。flash.geom.Matrix ク ラス の createGradient 
Box0 メ ソ ッ ド で 作成 し た 変換 マト リッ クス を 指定 で きま す 。 
spreadMethod : グラ デー ショ ン の パタ ー ン を 決定 する 
Spread メ ソ ッ ド を 指定 で きま す 。SpreadMethod ク ラス に 
PAD、REFLECT、REPEAT の 3 種類 の 定数 が 用 意 さ れ て いま す 。 
IinterpolationMethod : グラ デー ショ ン を レン ダリ ング す 
る と き に 使用 する RGB ス ペー ス を 決定 し ます 。 
InterpolationMethod.LINEAR_RGB (線形 RGB 補 間 メ ソ ッ ド 
を 使用 )、InterpolationMethod.RGB (RGB 補 間 メ ソ ッ ド を 
使用 : デフ ォ ル ト ) を 選択 で きま す 。 

focalPointRatio : グラ デー ショ ン の 焦点 を 制御 する 数 値 を 
-1 >1 の 範囲 で 指定 し ます 。 

















よく ある Flash サ ンプ ル と 同じ よう に R 
GB3 色 に よる グラ デー ショ ン を 行っ て 
ます が 、 少 し アレ ンジ を 加え て alphas 
配列 を 変化 させ て いま す 










34 1 


グラ フィ ッ ク 措 画 


ーーーー 


beginGradientFil() に よる グラ デー ショ ン GraphicsSampleD.fla 
1mport flash.d1isplay . ShaDpe : 
PART / / 描画 を 行う た め の 8Shape オ ブ ジ ェクト 変数 
Var Campu8 : ShaD6 : 
//co1org 配 列 
var co1or8g : Ar エエ ay= [0xFF0000,0x00FF00,0x0000FF] : 一 ①colors 配列 で HGB3 色 を 決定 
//a1phag 配 列 
Var a1pha8 : AT エ ayY : 
/ /ratiog 配 別 
きま きも も 08:AYYSyst6,127.2551 ) 一 一 ーーーーーーー デ ーーーーーーーー (ウー 年 の 分 布 比率 を 定 半 
/ /Matr ュ ix オブ ジェ クト 変数 


Ya ma ヒエ ュ 1x : Ma ヒエ 1 ュ X: 
/ / グ ラ デ ー シ ョ ン 知 形 を 描く 関数 
function drawShapes ( ) : vo1d { 
/ / 描画 オブ ジェ クト の 生成 
Campu8 = new Shape ( ) 』 
/ /Ma ヒ 上 エ ュ ix オブ ジェ クト の 生成 
matr1ix = new Matr1X() : 
/ / グ ラ デ ー シ ョ ンマ トリ ックス オブ ジェ クト の 生成 
matrix .createGradientBox ( this . stage . StageW1dth, thig . Stade . 
stageHetehe / 10。 0. 60. 0 ): ③ ル ー プ で 10 回 Rect を 描画 





for (var +:int = 0: 1 < 10: 1++) 1{ 
//a1pha 値 を ルー プ ご と に 変更 
a1phag= [1/10,1.0,1-1/10] 
//beginGradientF111 ( ) の 実行 





④alphas 配 列 を ルー プイ ン デ ックス 変数 で 変化 させ る 


campus .draphics .beginGrad1entFi1] ( GradienEType .hTNEAR , Co1Or8, 
a1phags, ratios, matr1ix ): 
/ / 知 形 を 描く 
campus .graphics .drawRect( 0, 1 * (this.stage . StageHe1ghE / 10), 
this . stage . stageW1dth, this . stage . StageHe1ght / 10 ): 
Campu8 .draph1cg . endF111 () : 

) 

/ / 表 示 リ スト に 追加 

addChi1d (campu8) : 


) 


drawShapeg8 ( ) : 
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9 - 1] サウ ンド 
リル アル 4 アル ん スコ ゴー ビ を 





ActionScript で 外部 サウ ンド ファ イル を 処理 する に は 、 ま すず Flash Player に サウ ンド を ロー 
ド す る 必要 が あり ます 。 サ ウン ドリ ソー ス を ロー ド す る 場合 、 リ ソー ス ご と に Sound ク ラス の 
イン スタ ンス を 生成 し て 処理 を 行い ます 。Sound ク ラス は MP3 形 式 の サウ ンド ファ イル を サポ 
ー ト し ます 。 サ ウン ドリ ソー ス フ ァ イル を ロー ド す る 場合 、 そ の 場所 を 示す URLRequest イ ン 
スタ ンス を 作成 し て 、Sound オ ブ ジ ェクト の load() メ ソ ッ ド に 渡す と ロー ド が 開始 され ます 。 
ロー ド が 完了 する と 、Sound オ ブ ジ ェクト は Event.COMPLETE イ ベン ト を 送出 し て ファ イル 
は 再生 可能 に な り ま す 。 コ ンス トラ クタ で URLRequest オ ブ ジ ェクト を 指定 し た 場合 、 目 動 的 
に load() メ ソ ッ ド が 呼び 出さ れ ま す 。MP3 フ ァイル に 関し て は 、 作 者 や ジャ ン ル な ご ど を 記録 し 
た ID3 タ グ と 呼ば れる メタ 情報 も 取得 可能 で す 。 Sound ク ラス の イベ ント に つい て は 、 莉 注 
「 サ ウン ド の イベ ント を 処理 する 」 を ご 覧 くだ さい 。Flash Player が 扱う サウ ンド デー タ は ダウ 
ン ロ ー ド する ファ イル の み で は な く 、 外 部 マイ ク 入 力 や スト リー ミン グ サ ー バ か ら の サウ ンド 
デー タ も 含ま れ ま す 。 Flash Player が ロー ド で きる サウ ンド ソー ス 、 サ ウン ド 処 理 を 行う た め 
の flash.media バ パッ ケー ジ ク ラ ス 、MP3 の メタ 情報 を 下 表 に まとめ まし た 。 


和 mm Flash Player で ロー ド 可 能 な サウ ンド ソー ス 









































外部 サウ ンド ファ イル 実行 時 に ロー ド し た ファ イル 、 ま た は SWF に 埋め 込ん だ サウ ンド ファ イル 
| マイ ク | ユー ザ 環境 で 利用 可能 な マイ ク 入 力 
| メデ ティア サー バ | リモ ー ト メデ ィ ア サー バー か ら ス トリ ー ミ ング され る サウ ンド 
| 89 に 生成 れ た サウ ンド ] Flash Player が 動 的 に 作成 し た サウ ンド 














舌 flash.media バッ ケー ジ の サワ ンド 処理 クラ ス 














クラ ス 機能 

Sound サウ ンド の ロー ド 、 サ ウン ド プ ロ パ ティ の 管理 、 サ ウン ド 再 生 の 開始 を 
行い ます 。 

SoundChannel アプ リケーション 内 で サウ ンド を 制御 し ます 。 サ ウン ド は すべ て サウ ン 


ド チ ャ ン ネ ル に 割り 当て られ ます 。 再生 さ れる それ ぞ れ の サウ ンド に は 、 
独自 の SoundChannel オ ブ ジ ェクト が あり 、 サ ウン ド の 左 再 生 チ ャ ン ネ 
ル と 右 再 生 チ ャ ン ネ ル の ボリ ュー ム を 制御 し ます 。 ア プリ ケー ショ ン が 
Sound オ ブ ジ ェクト を 再生 する と 新しい SoundChannel オ ブ プ ジ ェ クト が 
作成 され 、 再 生 を 制御 で きま す 。 




















メー ゴー 
サウ ンド ファ イル を ロー ド す る 


斬 flash.media バ パッケージ の サウ ンド 処理 クラ ス (続き ) 
ロー ド す る ファ イル の セキ ュ リ ティ チェ ッ ク を 提供 し ます 。 サ ウン ド の 
ロー ド 中 に 何 秒 間 バ ッ フ ァ リ ング する か 、 ま た 、 フ ァイル の ロー ド 中 に 
Flash Player ま た は AIR が サー バー の ポリ シー ファ イル を 検索 する か ど 


うか を 指定 し ます 。SoundLoaderContext オ ブ ジ ェクト は 、Sound.loa 
d() メ ソ ッ ド の パラ メー タ で 使用 され ます 。 


アプ リケーション の 埋め 込ま れ た スト リー ミン グ サ ウン ド を 制御 し ます 。 
共通 の SoundMixer オ ブ ジ ェクト を 通じ て 複数 の サウ ンド チャ ン ネ ル が 
合成 され る の で 、SoundMixer オ プ ジ ェ クト の プロ パテ ィ 値 は 、 再 生 中 
の すべ て の SoundChannel オ ブ ジ ェクト に 影響 を 与え ます 。ActionScri 
pt で 生成 され た サウ ンド は 制御 で きま せん 。 


ボリ ュー ム と パン を 制御 する プロ パテ ィ を 持ち ます 。SoundTransform 
オブ ジェ クト は 、SoundChannel オ ブ ジ ェクト 、 グ ロー バル な Sound 
Mixer オ プ ジ ェ クト 、Microphone オ ブ ジ ェクト な ど に 適用 され ます 。 


通常 MP3 サ ウン ド フ ァイル に 格納 され る ID3 メ タデ ー タ 情報 を 表す プロ 
パテ ィ が 含ま れ て いま す 。Sound ク ラス の id3 プ ロ パ ティ に アク セス し 
て 、MP3 フ ァイル か ら 追 加 の メタ デー タ を 取得 で きま す 。 


コン ピュ ー タ に 接続 され た マイ ク や その 他 の サウ ンド 入力 デバ イス か ら 
オー ディ オ を キャ プチ ャ で きま す 。 マ イク か ら の オー ディ オ 入 力 は ロー 
カル の スピ ー カ ー に 転送 され る か 、 リ モー ト サ ー バ ー に 送信 され ます 。 
MicropDhone オ ブ ジ ェクト は 、 独 自 の サウ ンド スト リー ム の ゲイ ン 、 サ 
ンプ リン グレ ー ト 、 お よび その 他 の 性 質 を 制御 し ます 。 











SoundLoaderContext 


SoundTransform 


ID3Info 


特 Sound ク ラス の id3 プロ バテ ィ で 参照 可能 な MP3 メタ デー タ 
(XXXX の 部 分 ) 


ID3 タ グ 内 容 
Sound.id3.XXXX 


音 に 関す る コメ ント comment/COMM 
TPE1 アー ディ ズ ト 名 
TYER 音 さ れ た 年 

内 容 の 属す る グル ー プ の 説明 

タイ トル / 曲 名 / 内 容 の 説明 

サブ タイ トル / 説 明 の 追加 情報 















































参照 プロ パテ ィ 名 
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重 Sound クラ ス の id3 プロ パテ ィ で 参照 可能 な MP3 メタ デー タ (続き ) 

参照 プロ パテ ィ 名 
(XXXX の 部 分 ) 
Sound.id3.XXXX 


本 還 に 
オリ ジ ナ ル の アル バム / ム ー ビ ー / シ ョ ー の タイ トル 
オリ ジ ナ ル の ファ イル 名 
オリ ジ ナ ル の 作詞 家 / 文 書 作 成 者 
オリ ジ ナ ル の アー ティ スト 演奏 者 
ファ イル の 所 有 者 / ラ イセ ンス 保持 者 
翻訳 、 リ ミッ クス 、 そ の 他 の 修正 を 行っ た 人 
トラ ッ ク 番 号 / セ ッ ト 内 の 位置 
イン ター ネッ トラ ジオ 局 の 名 前 
イン ター ネッ トラ ジオ 局 の 所 有 者 
TSRC ISRC (国際 標準 録音 資料 コー ド ) 
エン コー ド に 使用 し た ソフ トウ ェ ア / ハ ー ド ウェ ア と 設定 
sm _ 
URL リン シンク フレ ー ム WXXX 


※COMM ~ー TYER の メタ デー タ に つい て は 、 ID3Info ク ラス に プロ パテ ィ と し て 定義 され て いる 
た め 、 プ ロ パ ティ 名 が 2 つつ 存 在 す る こと に な り 、 ど ちら か ら も 取得 可能 で す 。 





















計 
: 


則 | 
表 















職 で 
サウ ンド ファ イル を ロー ド す る 


符 Sound ク ラス の 主 な プロ パテ ィ 概 要 


利用 可能 な バイ ト 数 を 調 | bytesLoaded : uint [読み 取り 専用 ] Sound オ ブ ジ ェクト で 現在 
べ る 利用 で きる デー タ の バイ ト 数 を 表し ます 。 
オブ ジェ クト の 合計 バイ | bytesTota1 : int [読み 取り 専用 ] オブ ジェ クト の 合計 バイ 
ト 数 を 調べ る ト 数 を 表し ます 。 


MP3 フ ァイル の メタ デー | id3 : ID3Tnfo [読み 取り 専用 ] MP3 フ ァイル が 持つ メタ 

タ を 調べ る デー タ を 表す ID3Info オ ブ ジ ェクト に アク 
セス で きま す 。 

MP3 フ ァイル が バッ ファ | isBuffering : Boo1ean [読み 取り 専用 ] true の 場合 、 外 部 MP3 

リン グ し て いる か 調べ る ファ イル が バッ ファ リン グ 中 で す 。 

サウ ンド の 継続 時 間 を 調 | 1ength :Number [読み 取り 専用 ] サウ ンド の 継続 時 間 を ミ 

べ る リ 秒 数 で 表し ます 。 

サウ ンド が ロー ド さ れる | ur1 : String [読み 取り 専用 ] サウ ンド が ロー ド さ れる 

URL を 調べ る URL を 表し ます 。 


年 Sound クラ ス の 主 な メソ ッ ド 概要 


コン スト ラク タ Sound ( 新しい Sound オ ブ ジ ェクト を 
gtream : URLRequest = nu11, 作成 し ます 。stream に URLRe 
Context : SounQdLoaderContexE = nu11 | guest オブ ジェ クト を 指定 し 






























































し ます 。 
スト リー ム を 閉じ て サウ ンド 
デー タ の ダウ ン ロ ー ド を 中 止 
し ます 。 


オブ ジェ クト か ら 生 の サウ ン 
ド デ ー タ を 抽出 し ます 。 















スト リー ム で ダウ ン 
ロー ド を 中 止 す る 


COge ( ) :Vo1d 

























生 の サウ ンド デー タ 
を 抽出 する 


GX ヒ エ aC ( 
ヒ ard6G : By 上 GArraY , 
engthNumDber , 

St 上 ar 上 Pog1 ェ ion : Number = -1 
) : Number 




























1oad ( 

8 上 ream : URLRequegt , 

Contex : SOundLoaderContext = nu]1 
) :void 


MP3 フ ァイル を ロー 
ド す る 


サウ ンド を 再生 する 


stream で 指定 し た URL か ら 
外部 MP3 フ ァイル の ロー ド を 
開始 し ます 。 


















サウ ンド を 再生 する Sound 
Channel オ ブ ジ ェクト を 新 し 
く 作成 し ます 。 


play ( 

8t 上 artT1me :Number = 0, 
IOODS:1nt = 0, 
SnQdTransfForm : SoundTransfForm = 
nu 1 

) : SoundChanne1 







た 場合 、 す ぐに ロー ド を 開始 | 
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ジン ド 


AMPLE ヒロ ロ ヒ EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEHEEEEEEEEEEEEEE 


MP3 ファ イル の ロー ド と 再生 SoundSampieAjla 


/ / サ ウン ド フ ァイル を ロー ド す る 関数 
PART Function 1oadSoumnd ( ) :vo1d { 
ya soundUr] 1 : URLRequest = new URLRequest ("sounds/Samp1eSound1 .mp3『" ) : 
yar sound1 : Sound = new Sound() : | 
// ロ ー ド 完了 時 の リス ナー の 登録 
gound1 . addEventTLii stener ( Event .COMPLETE, soundLoaded ): Pr 


) 
ン 





て 


⑥) 


gound1 . 1oad ( soundUr11 ) : 一 一 一 一 


// ロ ー ド が 完了 し た 場合 ひ の イ ベン ト ハ ンド ラ 

function soundTioaded (event : Event ) :Yo1d 1 一 一 ーーーーー 一 
trace ( (event .tarqget as Sound) .ur1 + " ファ イル が ロー ド さ れ ま し た 。" ): 
// タ ー ゲ ッ ト サ ウン ド を 才 生 する 


⑤) 





(event .tarqget ag Sound) .playY () : - 一 ーーーーーーーーーーーーーーーーーーー 
//TD3 rnEFo オ ブ ジ ェクト を 取得 ⑥ 
7 
90 る var 1d3:TD3Tnfo = evernt .target .1d3 ag8 TD3Tnfo: 


//TD3 TnEo ク ラス に 定義 され た プロ パテ ィ を 出力 

traoce ( "a1bum:" + 1d3.a1Dum ): 

tracCe ( "art1igt:" + 1d3.art18gt ): 

trace( "comment:" + 1d3.cComment ): 

traoe ( "genre:" + 1d3.genre ): em キーーーーーーーーーーー ヤ ーー デーーーーーーー 
trace ( "sonqgName:" + 1d3.songName ): 

trace ( "Eraok:" + 1d3.EraCKk ): 

traoe ( "year:" + 1d3.year ): 

//TD3 Info オ ブ ジ ェクト の 全 プ ロ パ ティ を 出力 

trace( "-- す べ て の プロ パテ ィ を 出力 し ます --" ): 


fa 
For ( var idqd3Prop:Strinqg 1n 1d3 ) { 
trace( 1d3Prop + ": リ + 1d3[ 1d3Prop ] ): RPM 
) 
) 
1oadSoumnd ( ) : 


や で ロー ド す る リソー ス (ここ で は MP3 フ ァイル ) を 示す URLRequest オ ブ ジ ェクト を 作成 
し て いま す 。@⑧ で は 、 ロ ー ド が 完了 し た と き の イ ベン ト ハ ンド ラ を 登録 し 、③ で ロー ド を 開始 
し ます 。④ か ら が イベ ント ハン ドラ で す が 、⑤ で ター ゲッ ト の サウ ンド オブ ジェ クト に 対し て 
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9- 1ー1 
サウ ンド ファ イル を ロー ド す る 


play() メ ソ ッ ド を 実行 し て ロー ド し た サウ ンド を 再生 し ます 。⑥⑤ 以 降 は Sound オ ブ ジ ェクト の 
id3 プ ロバ ティ で アク セス 可能 な ID3 メ タデ ー タ を 出力 し て いま す 。⑦ で は 、ID3Info ク ラス に 
プロ バテ ィ と し て 定義 済み の ID3 メ タデ ー タ を 出力 し ます 。⑧ の for ル ー プ で すべ て の メタ デー 
タタ を 出力 し て いま す 。MP3 フ ァイル に 定義 され て いな い メ タデ ー タ は 出力 され ませ ん 。 


ぁ 実行 結果 (出力 例 ) 


Fi]e : ///C| / sounds/Samp1eSound1 .mp53 ファ イル が ロー ド さ れ ま し た 。 
a1bum : サン プル アル バム 

art1igt 上 : サン プル アー ティ スト 

comment : コメ ント は 特に あり ませ ん 。 

enr@ : (12 ) 

8ondName :Flash Act1onScr1pt3 .0 リ ファ レン ス サ ン プル サウ ンド 1 
上 raCKk : nu 1 

Year:2010-01-01 

- - す べ て の プロ パテ ィ を 出力 し ます - - 

TALB : サン プル アル バム 

COMM : コメ ント は 特に あり ませ ん 。 

TITT2:Flash Act1onSor1pt 上 3 .0 リ ファ レン ス サ ン プル サウ ンド 1 
TYER:2010-01-01 

TCON : (12) 

PPE1 : サン プル アー ティ スト 


- - サ ウン ド が 再生 され ます - - 
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2 Sound イ ベン ト を 処理 する 





PART サウ ンド デー タ を ロー ド す る 場合 、 イベント に より 状況 を 確認 する 必要 が あり ます 。 通常 は 
ロー ド に 失敗 し た り 、 読 み 込み 中 の オブ ジェ クト を 再生 する こと が で き な い た めで す 。Sound 
オブ ジェ クト は 下 表 の イベ ント を 送出 し ます 。 再生 を 開始 する タイ ミン グ は 、complete イ ベ 
ント の 発生 後に な り ま す 。 


引 SOund ク ラズ の 主 ほ ば イペ ント ーー ーー 
タイ ミン グ | イベ ント 名 イベ ント の 板 要 」 













































































ek | open サウ ンド の ロー ド 処 理 が 開始 する 直前 に 送出 さ 
| (定数 Event.OPEN) れ ま すず 。 
サウ ンド の ロー ド PrOdre88 サウ ンド の ロー ド プロ セス で デー タ が ファ イル 
プロ セス 中 (定数 ProgressEvent. | また は スト リー ム か ら 受 信 さ れる 間 、 定 期 的 に 
| PROGRESS) 送出 され ます 。 
ID3 デ ー タ が 使用 可能 1d3 MP3 サ ウン ド で ID3 デ ー タ が 使用 可能 に な る と 
MK (定数 Event.ID3) 捧 出さ れ ま す 。 | 
サウ ンド の ロー ド 終 了 COmp1ete サウ ンド デー タ の ロー ド が 完了 する と 送 出さ れ 
(定数 Event.COMPLETE) | ます 。 
サウ ンド の ロー ド 和 失敗 1OE エ エ の Or サウ ンド ファ イル が 見 つか ら な い 場 合 、 また は 
(定数 IOErrorEvent.IO_ サウ ンド デー タ の ロー ド プ ロ セ ス が 中 断 さ れる 
ERROR) と 送出 され ます 。 























等 SOund クラ ス の メソ ッ ド 詳細 























メソ ッ ド |* メソ ッ ド の 詳細 
1oad | stream : ロー ド す る MP3 サ ウン ドン ファ ァイル を 表す URLRequest 
stream : URLReque8t , オブ ジェ クト で す 。 こ の URL で 指定 され る 外部 MP3 フ ァイル の 
context : ロー ド を 開始 し ます 。 
SoundLioaderContext = load() メ ソ ッ ド に よる サウ ンド リソー ス の ロー ド 時 に も Flash 
nu1 1 Player の セキ ュ リ ティ サン ド ボ ッ クス は 有効 で す 。 サ ンド ボッ ク 
| ) :void ス 違 反 と な る ロー ド を 実行 し た 場合 、「 セ キュ リティ Sandbox 違 
反 」 例外 が 発生 し ます 。 セ キュ リティ ポリ シー ファ イル を 設置 し 
て クロ ス ド メ イン アク セス を 行う 場合 、checkPolicyFile ブ プロ パ 





ティ を true に 設定 し た SOundLoaderContert オ プ ジ ェ クト を 
context パ ラメ ー タ に 指定 し ます 。 











] 
c1osge ( ) :Yoid スト リー ミン グ サ ウン ド の ロー ド と 再生 を 中 止 し ます 。 スト リー 
ム さ れ て いな い サ ウン ド の 場合 、 こ の メソ ッ ド に より エラ ー が 発 
生 し ます 。 
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9-1-2 
Sound イ ベン ト を 処理 する 


符 Sound ク ラス の メソ ッ ド 詳細 (続き) 


play ( サウ ンド を 再生 する SoundChannel オ ブ ジ ェクト を 新しく 作成 し 
startTime :Number = 0, て 返し ます 。 こ の オブ ジェ クト に より 、 サ ウン ド の 停止 、 ボ リュ 
1oops:int = 0, ー ム の 監視 を 行い ます 。 ボ リュ ー ム の 制御 、 パ ン 、 バラ ンス の 設 
sndTransform : 定 を 行う に は 、 サ ウン ド チ ャ ン ネ ル に 割り 当て られ た SoundTrans 
SoundTransfForm = nu11 form オ ブ ジ ェクト を 使用 し ます 。 

) : SoundChanne1 startTime : 再生 を 開始 する 位置 を ミリ 秒 単位 で 設定 で きま す 。 
loop : 再生 を 繰り 返す 回 数 を 指定 で きま す 。 

sndTransform : ボリ ュー ム と パン 情報 を 持つ SoundgTransfor 
m オ ブ ジ ェクト を 割り 当て る こと で 、 再 生 時 の ボリ ュー ム と パン 
を 指定 で きま す 。 



























AMPLE ビ ロ D ロ FE EEEEEEEEEEEEEEEEEEE 


MP3 サ ウン ド を ロー ド し て イベ ント を 監視 する SoundSampieB.fla 


1mport Flash . evens . Event : 


1mport Flash .events . ProgressEvent : 


1mport Flash .media . Sound : 


1import fF1ash .net .URLRequest 


//Sound オ ブ ジ ェクト 変数 

Va 8Ound : SOund : 

/ /URLRegues 上 オブ ジェ クト 変数 
Var url :URLRequegt : 


/ / 初期 化 処理 関数 
function init() :void {1 
// ロ ー ド 開始 ボタ ン の イベ ント ハン ドラ 登録 
Star btn.addEventLi1 stener (MouseEvent .CLTCK, 8tartTLioad ) : 


) 


/ / サ ウン ド デ ー タ を ロー ド す る 関数 

Function star て Load (event :MouseEvent ) :void 1 
/ / Sound オ ブ ジ ェクト の 生成 と イベ ント リス ナー 登録 
8OunQd = new Sound () : 
SounQd . addEventListener (ProgressEvent . PROGRESS, SoundLioadProdre88) : 
8ound . addEventLi stener (Event . COMPLETE , 8oundLoadComp1ete) : 
Sound.addEventL1stener (TOErrorEvent . TO ERROR , SoundTOE エ ro て ) : 
OuEpu ( ur] txt.texE 上 + " を ロー ド し ます " ): 
url=new URLReques (ur] て txt .tex) : 
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PART 
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/ / ロ ー ド を 開始 


sound.1oad( ur1] ): 





た た 誠 給 共 (が YO ー ーー① 
Function soundLioadProgres8 (event : ProgressEVent ) : VO1d { 

/ / ロ ー ド 済み の サイ ズ か ら パ ー セ ント 算出 

Var peroentLioaded : u1n 七 = 

Math . round( (event .bytesLoaded / evernt .bytesTota1) * 100 ) : 

output ( "Progres8 イベ ント :" + peroentLoaded + 『 を ロー ド し まし た " ): 


// ロ ー ド 完了 イベ ント ハン ドラ 

Function soundLioadComp1ete (event : Event ) :vo1d { 
output ("Comp1lete イベ ント : ロー ド が 完了 し まし た " ): 
/ / サ ウン ド オ ブ ジ ェクト の pl1ay ( ) メソ ッ ド で 再生 を 開始 
8ound .play () : 

) 8ound .p1ay ( ) : 


// TOError イ ベン ト ハ ンド ラ 

Function soundTOError (event : TOErrorEvent) { 
output ( "例外 が 発生 し まし た 。" + e.name + ": リ + @G.meG88ad@e ) 
output ( "TOError イベ ント : ロー ド が 失敗 し まし た " ): 


// メ ッ セ ー ジ を 出力 する 関数 
Function output (msg : String) :vo1d { 


Outpu 七 上 a .Eext += m8d+" ぎ nmP: 


生計 穫 ます 2 


MP3 サ ウン ド を ロー ド す る 際 に 行う 基本 処理 で す 。 イ メー ジ や SWF の ロー ド 時 と 同様 に 、 サ 
ウン ド の ロー ド 時 に も progress イ ベン ト が 発生 し て ロー ド 済 み バ イト 数 を 取得 で きま す 。 そ の 
処理 は ① の イベ ント ハン ドラ で 行っ て いま す 。 終了 する と complete イ ベン ト 、 和 失敗 する と 
ioError イ ベン ト が 発生 し ます 。 ロ ー ド 時 に 考慮 すべ きこ と と し て 、Flash Player の セキ ュ リ 
ティ 違反 が あり ます 。 例 えば ロー カル SWF を 実行 時 に イン ター ネッ ト 上 の Web サ ー バ か ら 
MP3 を ロー ド し よう と する と 、 次 の エラ ー と と も に 処理 を 終了 し ます 。 


9-1-2 
Sound イ ベン ト を 処理 する 






実行 結果 出力 ビュ ー の エラ ー( 一 部 ) 





お 客 様 の コン ピュ ー タ ー ま た | は ネッ トワ ー ク で の ロー カル アプ リケーション : 
V\documents\bw\Softbank\as*fla\for Users\SoundSampleB swf 
は 、 イン ター ネッ ト 岳 続 が 有効 こ な っ て いる 次 の 場所 の 通信 し よう と し て いま す : 








雄 |88 に siueAeeb.。 | 還 Ab-。 uek。 | 彩 s.x。| | 和合 ・ 回 ・ ロ 婦 ・ は * ウッ な >⑨・ 


1 


Progress イベ ント :63 % ロ ー ド し まし た 
Progress イベ ント:64 % ロ ー ド し まし た 
Progress イベ ント :66 % ロ ー ド し まし た 
Progress イベ ント :67 % ロ ー ド し まし た 
Progress イベ ント :69 % ロ ー ド し まし た 
Progress イベ ント :71 % ロ ー ド し まし た 
Progress イベ ント :72 % ロ ー ド し まし た 
Progress イベ ント :74 % ロ ー ド し まし た 
Progress イベ ント :75 % ロ ー ド し まし た 
Progress イベ ント :77 % ロ ー ド し まし た 
Progress イベ ント :79 % ロ ーF ド し まし た 
Progress イベ ント :80 % ロ ー ド し まし た 
Progress イベ ント 82 % ロ ーF ド し まし た 
Progress イベ ント 83 % ロ ー ド し まし た 
Progress イベ ント :85 % ロ ー ド し まし た 
Progress イベ ント :87 各 ロ ー ド し まし た 
Progress イベ ント :88 % ロ ー ド し まし た 


omoPOYP ア ms デー ニー 


で Se 


ーー エーーー マー 了 <rer つ の で さい 


Progress イベ ント :90 % ロ ー ド し まし た 
Progress イベ ント :91 % ロ ー ド し まし た 
Progress イベ ント :93 % ロ ー ド し まし た 
Progress イベ ント :95 % ロ ー ド し まし た 
Progress イベ ント :96 % ロ ーF し まし た 
Progress イベ ント :98 % ロ ー ド し まし た 
Progress イベ ント 99 % ロ ー ド し まし た 
Progress イベ ント :100 % ロ ー ド し まし た 
Compiete イベ ント - ロー ド が 完了 し まし た 
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- 埋め 込み サウ ンド を 処理 する 





PART 外部 ファ イル の ロー ド で は な く 、 サ ウン ド を SWF に 埋め 込ん で 再生 で きま す 。 サ ウン ド を 埋 
め 込 お に は 、 オ ー サ リン グ 時 に サウ ンド ファ イル を ライ ブラ リ に 読み 込み 、「 詳 細 ] プロ バテ ィ 
で 「ActionScript 用 に 書き 出し 」 チェ ッ ク と と も に 、 ク ラス 名 を つけ て お きま す 。 ク ラス 名 に 
は 「.」 を 含め る こと が で き な い た め 、「_」 に 置き 換え る な ど し ま す 。 埋め 込み サウ ンド の 場合 、 
利用 可能 な サウ ンド ファ イル 形式 に は MP3 以 外 の も の も 含ま れ ま す 。Flash CS4/CS5 で 読み 込 
み 可 能 な サウ ンド ファ イル 形式 は 下 表 の と お り で す 。 


FlashCS4/ て CS5 で オー ジリ ング 時 に 読み 込み 可能 E な サウ ンド ファ イル 形式 



















































































| ファ イル 形式 | 対応 プラ ッ ト フ ォ ー ム (備考 ) 
MP3 Ndgwe / Meetoeh | 
ASND | eg 7 MGINHRGEESGAGD6 Soundbooth の ネイ ティ ブサ ウ ンド 形式 ) 
WAV NGOWe の み 
才 AlFF Macintosh の み 
 『! は QuickTime4 以 上 が イ ビル トー ル さ れ て いる 場合 に 読み 込み 可能 な 形式 























] ' ] 


| AlFF | Windows / Macintosh 














| seamd Designer ll Macintosh の み 








| ーー ー 
Sound Only QulcKTime moVIeS Windows / Macintosh 
































| Sun AU Windows / Macintosh 




















| 0 / SOun9S Macintosh の み 


ーーーーーーーーーーー 一 ーー 























| Wav | Windows / Macintosh 
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テー リー 
埋め 込み サウ ンド を 処理 する 











男 サウ ン ド プ ロ パ ティ に よる 埋め 込み サウ ン ee 


隊 SR La ビー ーー ・ 罰 : 
[ サウ ンド プロ パテ ィ に 







2 
較 






。 2006 年 7 月 7 日 7:4z:00 た ea トー ンー 
人 な 全 YNAe 『 い に 
44 MHz ステ レオ 16 ゼット 51.3 s 9050.9KB ーー 












gm 






ブリ ッシュ 訟 定 を (用 , MP3, 16 kbps, モノ ラル 





[ActionScript 用 に 書き 出 
し 」 に チェ ッ ク を つけ る 
クラ ス に は 「.」 が 含ま れ 
な いよ うに する 


デバ イス サウ ンド の の 還 F * 聞 


I 識 | テラ 
chonscrt 用 に 書き 出し の 








= た 問 肖 = 考 四 mp】 コ 蘭 - ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


埋め 込み サウ ンド の 再生 SoundSampleC.HHa 


Var 8:SampleSound3 way = new SampleSound3 wav() : 


8 .Dplay () : 


上 記 の 「 サ ウン ド プ ロ パ ティ に よる 埋め 込み サウ ンド クラ ス の 作成 」 で 使用 し た WAV ファ イ 
ル を 使用 し ます 。 フ ァイル 名 は SampleSound3.wav で す が 、 こ の ファ イル を 読み 込ん で ライ 
ブラ リプ ロ パ ティ の 詳細 で 「ActionScript 用 に 書き 出し 」 に チェ ッ ク を つけ る と 、 自 動 的 に 
「SampleSound3.wav] と いう クラ ス 名 が 生成 され ます 。 す で に 解説 し た よう に 、 こ こ で 「. 」 
は 言 め る こと が で き な い た め 、「.wav」 を 取り 除く か 、「_」 に 置き 換え る な ど し ま す 。 こ こ で は 、 
「SampleSound3_wav] と いう クラ ス 名 に し まし た 。OK を 押し て ダイ アロ グ を 閉じ る と 「 サ 
ウン ドク ラス プロ パテ ィ 設 定時 の 警告 」 が 表示 され ます が 、 こ れ は エラ ー で は あり ませ ん 。 ク 
ラズ 定義 が で きた ら サ ンプ ブル コード の よう に イン スタ ンス を 生成 し て Sound ク ラス の play) メ 
ソ ッ ド に より 、wav サ ウン ド が 再生 で きま す 。 
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。 サウ ンド の 再生 と 停止 、 
ボリ ュー ム と パン を 制御 する 





サウ ンド の 再生 は Sound オ ブ ジ ェクト で play() メ ソ ッ ド を 呼び 出す こと で 実行 され ます が 、 
停止 する に は 、play() メ ソ ッ ド が 返す SoundChannel オ ブ ジ ェクト の stop0 メ ソ ッ ド を 呼び 出 
す 必 要 が あり ます 。SoundChannel ク ラス に は 現在 の 再生 位置 や ボリ ュー ム を 取得 する ブ プロバ 
ティ が 用 意 さ れ て いま す 。 再生 中 の サウ ンド の ボリ ュー ム や バン を 制 件 する に は 、Sound 
Transform オ ブ ジ ェクト の プロ パテ ィ を 使用 し ます 。SoundTransform オ ブ ジ ェクト は Sound 
Channel オ ブ ジ ェクト の soundTransform プ ロ パ ティ で アク セス で きま す 。 再生 中 に ポリ ュー 
ム や パン を 変更 する に は 、 新 た に SoundTransform オ ブ ジ ェクト を 生成 し て SoundChannel 
オブ ジェ クト の soundTransform プ ロバ ティ に 設定 し ます 。 


と SOu ndChannel ク ラ ス の 主 な プロ バテ ィ 概 要 
プロ パテ ィ 名 
















プロ パテ ィ の 概要 



































左 / 右 チャ ン ネ ル の 現在 の | 1eftPeal [読み 取り 専用 ] 左 / 右 チャ ン ネ ル の 現在 の ボ | 
ボリ ュー ム を 取得 する ightPeak リュ ー ム を 取得 し ます 。0= 最 小 (無音 )、1= | 
レー 最大 を 表し ます 。 
| 再生 ポジ ショ ン を 取得 する posit1ion :Number | [読み 取り 専用 ] サウ ンド ファ イル 内 で 再生 さ 
| れ て いる 現在 の ボイン ト を 示し ます 。 
SoundTransform オ ブ ジ ェ ク | 8oundTranstOoTT サウ ンド チャ ン ネ ル に 割り 当て られ た Sound ( 
ト を 取得 / 設 定 す る : SoundTransform | Transform オ ブ ジ ェクト を 参照 / 設 定 し ます 。 


























* 5oundChannel ク ラス の 主 な メソ ッ ド 概要 
再生 を 停止 する 


















メソ ッ ド の 概要 
再生 し て いる サウ ンド を 停止 し ます 。 





















・ 〇 10 














mm SundTransform クラ ス の 主 な プロ バテ ィ 概 要 


プロ パテ ィ 名 


me : NumDer 







プロ パテ ィ の 概要 


現在 の ボリ ュー ム を 変更 / 取 得 し ます 。0= 最 
小 (無音 )、1= 最 大 を 表し ます 。 

左右 の パン を 設定 / 取 得 し ます 。-1= 左 に パン 、 
0= 中 央 、1= 右 に パン を 表し ます 。 









ボリ ュー ム を 変更 / 取 得する 

















| 左右 の バラ ンス を 変更 / 取 得 
する 














テー キー 條 
サウ ンド の 再生 と 停止 、 ボ リュ ー ム と パン を 制御 する 


畔 SOundTransform クラ ス の 主 な メソ ッ ド 概要 


メソ ゾ ッ ド の 概要 


コン スト ラク タ に より volume、pan プ ロ パ ティ を あら 
か じ め 設 定 し た オブ ジェ クト を 作成 し 、SoundChannel 
オブ ジェ クト の soundTransform プ ロ パ ティ に 適用 する 
こと で 再生 中 に ボリ ュー ム と パン を 変更 する こと が で き 
ます 。Sound オ ブ ジ ェクト の play() メ ソ ッ ド に Sound 
Transform オ ブ ジ ェクト を 渡し て 再生 開始 時 の ボリ ュー 
ム と パン を 決定 する こと も で きま す 。 





















SOunQdTransform ( 
Vo」 :Number = 1, 
pann1nqd:Number = 0O 
) 








一 バブ リッ シュ 設定 


ーーーーーーーーー 





Pa VoltlimG 








ーーーーーーーーーーー 一 









= ね | 訓 肖 = 者 mp】 コ 敵 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー- 


サウ ンド の 有 再生 と 停止 、 ボ ポリ ュー ム と パン SoundSampleD.fla 
//mp3 サ ウン ド フ ァイル 


var 8nQ : Samp1eSound3 Wav: 

/ /SoundChanne1 オ ブ ジ ェ ト 変数 

Var gnQ cn1 :SoundChanne] 

/ / 再生 位置 を 保持 する 変数 

Var 8nQ DO8:1nt = 0: 

/ /8oundTransFform オ ブ ジ ェクト 変数 

Var gt : SoundTransform: 

/ / 初期 処理 を 行う 関数 

funoction ni ( ) :void { 
// サ ウン ド フ ァイル の イン スタ ンス を 生成 
Snd = new SampleSound3 wav() : 
play_mc.addEventListener( MouseEvent .CLTCK, pl]ayit ): 
Pau8e mcC.addEventL1gstener( MouseEvent .CLTCK, pausett ): 
StOD_mC.addEventLigstener( MouseEvent .CLTCK, stopit ): 
//8oundTransFform オ ブ ジ ェクト を 生成 
8t = new SoundTransform( 0.5, 0 ): 
//Pan の スラ イダ ー イ ベン トリ スナ ー 
pan 81qdr.addEventListener ( Event .CHANGE, setPan ): 
//Vo1ume の スラ イダ ー イ ベン トリ スナ ー 


Vo 8s1dr.addEventListener ( Event .CHANGE, setVo1]ume ): っ 57 


PART 
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/ / 再生 を 行う 関数 

Funotion playit ( event :Event ) :vo1d { 
8nd cn] = gnd.play( gnd po8 ) :- 一 ①position プロ パテ イィ の 値 を play() メ ノッ ド の 引数 に 渡す 
Snd ocn] .SoundTranStOorm = 58: 

) 

/ / 一 時 停止 を 行う 関数 


Function pauseit ( event :Event ) :void {1 


1f ( gnd Cn] == nul」 ) retur1i: 
/ / 再生 位置 を 保持 
snd po8 = 8nd cn1 .pogition: ーーーーーーーーーーーーー position プロ バテ ィ の 値 を 保持 


Snd on1 .8StoDp() : 
) 
/ / 停 止 を 行う 関数 
Function stopit ( event :Event ) :vo1d { 
1f ( gnmd Cn] == nul] ) retur1: 
/ / 再 生 ポジ ショ ン を 先頭 に 
8nd _ DOS = 0: 
Snd cn1 .SEoDp() : 
) 
/ / Pan を 変更 する 関数 


Function setPan ( event :Event ) :void { 





gt .pan = (evenrnt .target ag S11qder) .Ya1ue: ③Pan の 値 を スラ イダ ー か ら 取 得 


④Pan の 値 を SoundChannel オ ブ ジ ェ ク 


は 1 お OIL 生か FR お も) ト の soundTransform プロ パテ ィ に 渡す 


) 
/ /Vo1ume を 変更 する 関数 
Function setVo1]ume ( event :Event ) :vo1d { 
gt .vo1ume = (event .target as S1ider) .Ya1ue : 一 ーーーーーーー ⑤ ボ リュ ユー ム を 取得 
ーーー 
) 
1n1 () : 


ライ ブラ リ に ある サウ ンド を 再生 する サン プル で す 。 サウ ンド オブ ジェ クト の 作成 は 、 
の サン プル と 同様 で す 。 こ の サン プル で は 、 一 時 停止 と 停止 、 パ ン と ボリ ュー ム の 変更 を 行い 
ます 。 一 時 停止 し た サウ ンド を 再開 する 場合 、② で 行っ て いる よう に 、position プ ロバ ティ の 
値 を 保持 し て お き 、① の よう に play() メ ソ ッ ド の 引数 に 渡す 必要 が あり ます 。Pan で 左右 の バ 
ラン ス を 変更 する 場合 と ボリ ュー ム を 変更 する 場合 、SoundTransform オ ブ ジ ェクト を 使用 す 
る 必要 が あり ます 。 


9 - 2 マイ ク 
マイ ク を 使用 する 





Microphone ク ラス を 使用 し て 、 マ イク な どの サウ ンド 入力 デバ イス の 情報 を 取得 し た り 、 
オー ディ オ 入 力 を キャ プチ ャ ー で きま す 。ActionScript で マイ ク を 使用 する に は 、 ま ず Micro 
phone ク ラス の static メ ソ ッ ド getMicrophone() を 呼び 出し て 、 イ ンス タン ス を 取得 し ます 。 
その 際 、 ブ ラウ ザ で 実行 する Flash ア プリ ケー ショ ン の 場合 、 マ イ ク へ の アク セス 許可 を 設 
する プラ イバシー ダイ アロ グ が 表示 され 、 ユ ー ザ が 拒 否 する と 、 ア プリ ケー ショ ン で は 
StatusEvent.STATUS イ ベン ト が 発生 し て 、Microphone オ ブ ジ ェクト の muted プ ロ パ ティ 
が true に な り ま す 。 こ の プロ パテ ィ は 、ActionScript で は 変更 で を ませ ん 。 マ イク か ら の 入力 
を スピ ー カ ー に 送る に は 、setLoopback() メ ソ ッ ド を 呼び 出し ます 。 音声 入力 は リソー ス を 消 
費 す る た め 、 マ イク か ら の 入力 レベ ル が 小さ いか 、 一 定期 間 入 力 が な い 場 合 、 マ イク が セッ 
ショ ン を 終了 し 、 再 び 一 定 以上 の 入力 が あっ た 場合 に セッ ショ ン を 開始 し ます 。 こ の タイ ミン 
グ を 知ら せる イベ ント が "activity "で す 。 最低 入 力 レ ベル と 期間 の 設定 は 、setSil 
enceLevel() メ ソ ッ ド で 行い ます 。 


暫 Microphone クラ ス の 主 な プロ パテ ィ _ 
プロ パテ ィ 名 






































































































プロ パテ ィ の 概要 
現在 の サウ ンド 量 を 調べ る aCE1V1tyLeve] | 【 読 み 取り 専用 ] マイ ク が 検知 し て いる 音 
| :Number 量 を 表し ます 。 
コー デック 名 を 取得 / 設 定 する =odec : St 上 rind オー ディ オ 圧 縮 に 使用 する コー デック 名 
を 取得 / 設 定 で きま す 。 
- 1 ーーー ] 
入力 ゲイ ン を 取得 / 変 更 す る | gain : Number マイ ク に よる サウ ンド の ゲイ ン (増幅 率 ) 
を 取得 / 設 定 で きま す 。 
コー の PT ウ ア E2B muted : Bool1ean [読み 取り 専用 ] ユー ザ が マイ ク へ の アク 
調べ る セス を 許可 し て いる 場合 、false に な り ま 
す 。 拒否 する と true に な り ま す 。 
現在 の サウ ンド キャ プチ ャ デバ | name : Stringq | [読み 取り 専用 ] サウ ン ドギー プチ ャ ルル ー 
イス の 名 前 を 取得 する ドウ ェ ア か ら 返 され る 現在 の サウ ンド 
キャ プチ ャ デバ イス の 名 前 を 表し ます 。 
| 使用 可能 な すべ て の サウ ンド 入 | names :Array ーー [読み 取り 専用 ] 使用 可能 な すべ て 
カカ デバ イス の 名 前 の 配列 を 取得 の サウ ンド キャ プチ ャ デバ イス 名 の スト 
| する | リン グ 配 列 で す 。 
| 入力 オー ディ オ の サン プル レー te : nt マイ ク の サウ ンド キャ プチ ャ レー ト (kHz) 
ト を 取得 / 変 更 する 」 を 表し ます 。 
ト 0 
マイ ク を 有効 に する た め に 必要 1 1 6 [読み 取り 専用 ] マイ ク を 有効 化し た り 、 
な サウ ンド 量 を 指定 する : Number 








activ'ty イ ベン ト を 送出 する た め に 必要 な 
音量 を 表し ます 。 
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四 Microphone クラ ス の 主 な プロ パテ ィ ( 続 き ) 


マイ ク が 無音 状態 で ある と 判断 [読み 取り 専用 ] マイ ク が サウ ンド 検知 を 
され る まで の 時 間 を 指定 する 停止 し て か ら activity イ ベン ト が 送出 され 
る まで の 時 間 (ミリ 秒 単 位 ) を 表し ます 。 
















引 1enCeT1meout : 
1n ヒ 









先 Microphone クラ ス の 主 な メソ ッ ド 概要 


Microphone オ ブ プ ジ | etM1CFOophOone 【 オー ディ オ を キャ プチ ャ する Microphone オ プ 
ェクト を 取得 する | index:1nt = -1 ジェ クト を 取得 し ます 。 通常 index は 渡し ませ ん 。 


) :M1CrODhOn6e 


ロー カル スピ ー カ ー | setLoopBacK ( マイ ク で キャ プチ ャ され た オー ディ オ を ロー カ 
に 音声 を 出力 する gtaqe : BOO1ean= ヒ ru ルス ピー カー に 転送 し ます 。 


) :VO1d 


サウ ンド と 見 な す 最 | setSi1enceLeve1 ( その レベ ル 以 上 を サウ ンド と 見 な す 最 小 入 力 レ 

小 入 力 レベ ル を 設定 | si1enceLeve1 :Numper, | ベル と 停止 を 判定 する 時 間 を 設定 で きま す 。 

する timeout :int = -1): silenceLevel : 0 一 100 で 最小 入力 レベ ル を 設 
vo1d 定 し ます 。100 に する と マイ ク が サウ ンド を 検 


知 し ませ ん 。 
timeout : ミリ 秒 で サウ ンド が 停止 し た と 判定 
する 時 間 を 設定 し ます 。 


オー ディ オフ ィ ー ド | setUseEchoSuppre881On ( オー ディ オ コ ー デ ッ ク の エコ ー 抑 制 機能 を 使用 

バッ ク が 発生 する リ | useEchoSuppreS81On: する か どう か を 指定 で きま す 。 

スク は 軽減 Boolean useEchoSuppression : true で エコ ー 制 御 を 行 
) :void いま す 。 


乱 Microphone クラ ス の 主 な イベ ント 


マイ ク が セッ ショ ン を 開始 また は 終了 し 


セッ ショ ン の 開始 / 終 了 aCt 1i ヾ ュ キ y 
(定数 ActivityEventACTIVITY) た と き に 送出 され ます 。 

マイ クス テー タス の 変更 | SEatug マイ ク が その ステ ー タ ス を レポ ー ト し た 
(定数 StatusEvent.STATUS) と き に 送出 され ます 。 


ーーーーー 


Microphone オブ ジェ クト を 使っ MicrophoneSample.fla 









イベ ント の 概要 














1mport Fl]agh . eveng .AC ヒ 11 上 YEVent : 
1mport Flash .evens . StatuSEVen : 
1mport fF1ash .media .M1CrOphone : 

/ /Microphone オ ブ ジ ェクト 変数 

Ya mto:M1CrODhOn6 : 


Ya QGV1CG8 : A ム エエ 8YV : 


アー 
マイ ク を 使用 する 


function nit () :void { 
/ /Microphone オ ブ ジ ェクト の 取得 


m1C=M1CrOphone . deEM1crophone ( ) : 一 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーー (① 





if ( mio == nu11 ) {1 

trace ( "接続 さ れ た 入力 デバ イス は あり ませ ん 。" ) : 

euTT : (の 
) 
/ / デ バイ ス 名 の 取得 表示 


deV1Ceg=M1Crophone . nameg 
trace( "入力 デバ イス の 数 :" + devices .1ength )。: 
Eor (Var 1:int = 0: i < devices.1ength: 1++) 1 
Erace ("人 人力 デバ イス (" + ュ エ + ィ "):| " + devices [1] ) : 
) 
/ /Microphone オ ブ ジ ェクト の プロ パテ ィ 
/ / ゲ イン (増幅 率 ) 
m1C.da1n = 40: 
// キ ャ メチ ャ ー レ デ ト 
m1C.YaEe = 11: 
/ / エ コー 制御 を 行う 
m1o .setUseEchoSuppre881on (true) : 
/ / ロ ー カ ルス ピー カー に 転送 
m1C . SetLoopBack (true) : 
/ / 最 小 入 力 レ ベル と タイ ム ア ウ ト 時 間 
m1C.8etS11enoeLeve1'(20, 3000) : 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーー ③) 
/ /Microphone オ ブ ジ ェクト の イベ ント リス ナー 
m1C .aQdQEVen て 1 st 上 ener (Ac 上 1Y1tyEvent .ACTTVTTY, miocAot ): 
m1cC .addEventL1stener (StatusEvent . STATUS, mioStatugs ): 
) 
function mtoAct (event : ActivityEvent ) : vo1d { 
trace ( "ac も tiV1tY イベ ント : 『 + 
"act1vatingd( デ バイ ス =act1Ve ) =" + event .activatinq + 
", Microphone . . aC 上 1V1tyLeve]=" + mio.activityLieve1 ) : 


Func1on mtocStaEus (event : StatusEvent ) :void { 


Erace ("gtatu8 イベ ント : 『 + 
! 1eve1 (カテ ゴリ ) =" + event .1eve1] + 
", Code (ステ ー タ ス ) =" + event .code + 
"。 Miorophone .muted=" + mic.muted ) : 一 一 ーーーーーーーーーーーーーーーーーーーー ④ 
) 
1n ュ 上 () : 
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テー ば 
マイ ク 


① で Microphone オ ブ ジ ェクト を 取得 し て いま す が 、 こ の 時 点 で 接続 され た マイ ク が な い 場 
合 、mic は null と な る の で 、②⑧ で return し て 終了 し ます 。 マ イク が 接続 され て いる 場合 、 下 記 
の よう な Flash Player 設 定 ダ イア ログ が 表示 され ます 。 ユ ー ザ が 拒否 する と 、status イ ベン ト 
samT が 発生 し て イベ ント ハン ドラ が 呼び 出さ れ ま す 。 そ の 場合 、④ の muted プ ロバ ティ が true に な 
り ま す 。 ユ ー ザ が 許可 する と 、③ で 設定 し た マイ ク の 最低 入力 レベ ル と 時 間 に 基づい て マイ ク 
の セッ ショ ン が 切断 / ア クティ ブ と 変化 し ます 。 その た びに status イ ベン ト が 発生 し ます 。 








実行 結果 ※ ユ ー ザ が 拒否 し た 場合 の 出力 例 
入力 デバ イス の 数 : 1 
入力 デバ イス (0 ) : マイ ク (2 - Rea1tek Hiqgh DefE1n1 セ 
gtatus イベ ント : 1eve1 (カテ ゴリ ) =status , Code (ステー タス ) =M1crophone . Muted , 


M1Crophone . mu 上 teGd= キ TuG 


実行 結果 ※ ユ ー ザ が 許可 し た 場合 の 出力 例 
入力 デバ イス の 数 : 1 
入力 デバ イス (0 ) : マイ ク (2 - Rea1tek High Definit 
gtatus イベ ント : 1eve1 (カテ ゴリ ) =sgtatus , Code (ステー タス) =M1crophone . 
Unmuted, Miorophone . muted=fFa] se 
actiyity イベ ント : activating( デ バイ ス =aot1ve ) = 上 rue , M1CrODphone . . 
ac 上 1 ユマ 1 モエ YYLGVe =25 
activity イベ ント : activating( デ バイ ス =act1ve ) =fFalse, M1CrOphone . . 
acC 上 1 で 1 ユ モエ yLGVe ユ =0 
activity イベ ント : activating( デ バイ ス =active ) =true , M1Crophone . . 


aC 上 1 ユエ 上 yhGVe] =44 
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9 - 3 ビデ オ 
4F)/ 上 (9ー ピス エンス xr< 


セル ルイ に ネ まつ 





FLV (Flash Video) 形式 は Web で は も っ と も 使用 され て いる ビデ オフ ォ ー マ ッ ト で す 。 Flash 
は その 配信 に 関し て 強力 な ソリ ュー ショ ン を 提供 し ます 。Flash で ビデ オ を 配信 する 場合 、 次 
の よう な いく つか の 方 式 が 選択 可能 で す 。 


・Adobe Flash Media Server に よる ビデ オ の スト リー ミン グ 
・Web サー バー か ら の ビデ オ の プロ グレ ッ シ ブ ダウ ン ロ ー ド 
・Flash ドキ ュ メ ント へ の ビデ オ の 埋め 込み 


クラ イア ント を Flash で 構築 する 場合 、FLVPlayback コ ン ポ ー ネ ン ト が 用 意 さ れ て お り 、 簡 
里 な 設定 で スト リー ミン グ お よび プロ グレ ッ シ ブ ダウ ン ロ ー ド に よる 再生 を 行う こと が で きま 
す 。FLVPlayback に は 再生 や ボリ ュー ムコ ント ロー ル 、 巻 き 戻 し ボタ ン な ど を 備え た スキ ン が 
用 意 ご れ て お り 、 選 択 で を ます 。 プ ロ パ ティ の 設定 の み で 再生 を 行う こと が で きま す が 、 
ソ ッ ド も 多く 用 意 さ ご され て お り 、ActionScript に よる 処理 を 追加 で きま す 。 emm 
ビデ オ の 再生 手順 は 次 の よう に な り ま す 。 


暫 FLVPlayback クラ ス で ビデ オ 再 生 を 行う 手順 


ここ 作業 内 容 


FLVPlayback コ ン ボ ポー ネン ト を ステ ー ジ に 配置 し て プロ パテ ィ を 設定 し ます 。 
ビデ オ ソ ー ス を 表す プロ パテ ィ は ActionScript 3 の 場合 、source で 、 こ こ に ビデ オ コ ン テン ツ 
また は XML ファ イル の URL を 設定 し ます 。 設定 は デザ イ ン 時 に も 行え ます 。 

















2 デザ イン 時 に source を 指定 し て いる 場合 、Flash ム ー ビ ー を 再生 する と ビデ オ が ロー ド さ れ 、 
元 J 後 再生 が 始ま り ま す 。ActionScript で ロー ド を 開始 する 場合 、 load() メ ソ ッ ド を 使用 し ます 。 
ActionScript で イベ ント を 取得 し て 状況 を 把握 で きま す 。 




















田 FLVPlayback コン ポー ネン ト 
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PART 
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符 FLVPlayback クラ ス の 主 な プロ バテ ィ 概 要 
目的 プロ パテ ィ 名 プロ パテ ィ の 概要 


自動 再生 を 行う autoPlay true の 場合 、source プ ロ パ ティ の 設定 後に 自動 的 
: Boo]ean に FLV フ ァイル が 再生 され ます 。 
































自動 巻き 戻し を 行う autoRewind true の 場合 は 、 プ レー ヤー で スト リー ム の 最後 に 到 
: Boo]ean 達する か 、stop() メ ソ ッ ド が 呼び 出さ れ て 再生 が 停 


止 し た と き に 、FLV フ ァイル を フレ ー ム 1 に 巻き 戻 
し ます 。 


[読み 取り 専用 ] HTTP ダ ウン ロー ド の 進捗 状況 を 示 
す 数 値 (バイ ト 数 ) で す 。 


bytesTota1 :uint | [読み 取り 専用 ] HTTP ダ ウン ロー ド で ダウ ン ロ ー ド 
され た 総 バ イト 数 を 指定 する 数 値 で す 。 


FLVPlayback イン スタ ンス の 高 さ / 幅 を 指定 し ます 。 









ロー ド 済 み バ イト 数 を 
取得 する 


総 バ イト 数 を 取得 する 


bytesLoaded 
: 1 せ も 











he1qht : NumDer 
w1qdh : NumDer 
スト リー ミン グラ イブ isL1ve : Boolean ビデ オス トリ ー ム が ライ ブ で ある 場合 に true に な り 
指示 を 行う ます 。 

再生 済み の パー セン ト playheadPercen | 現在 の playheadTime 位 置 の totalTime に お ける パ 
を 取得 する age : NumDer ー セ ン テ ー ジ を 表し ます 。 


現在 の 再生 位置 を 調べ る | playheadTime 現在 の 再生 ヘッ ド の 時 間 ま た は 位置 を 秒 単 位 で 表し 
: Number ます 。 


FLVPlayback の 幅 と 高 さ 








ソー ス FLV フ ァイル の サ | preferredHeight | [読み 取り 専用 ] ソー ス FLV フ ァイル の 高 さ / 幅 を 指 
イズ を 調べ る : 1n 上 定 する 数 値 で す 。 


ロー ド し た ビデ オ の ロー ド 後 の ビデ オ サ イ ズ を FLV サ イズ に する か 、FLV 
サイ ズ を 決め る の 再生 サイ ズ を ビデ オ サ イ ズ に 合わ せる か を 指定 し 
ます 。 


FLV フ ァイル の URL を SOu エ Ce : St 上 rind スト リー ミン グ / ダ ウン ロー ド す る FLV フ ァイル の U 
指定 / 取 得する RL と スト リー ミン グ 方 法 を 指定 する スト リン グ で す 。 


ビデ オ 再 生 時 間 の 合計 | Eota1Time ビデ オ 再 生 時 間 の 合計 を 表す 数 値 ( 秒 単位 ) で す 。 
を 取得 する : NumDer 


ボリ ュー ムコ ント ロー ル | Yo1ume : NumDer ボリ ュー ムコ ント ロー ル 設 定 値 を ホ す 0~1 の 間 の 数 
設定 値 を 設定 / 取 得する 値 で す 。 





















CaleMode 
: 5 エエ 1nq 












乱 FLVPlayback クラ ス の 主 な メソ ッ ド 概要 






フル スク リー ン 表 示す | enterFu118ScreenDisp1ayStat | FLVPlayback ビ デオ プレ ー ヤ ー を フ 
る e ( ) :void ルス クリ ー ン に し ます 。 


FLV フ ァイル の ロー ド | 1oad( source で 指定 し た FLV フ ァイル の 口 




























を 開始 する SOU エ Ce : S 上 エ 1nd , ー ド を 開始 し ます 。 
tota1T1me :Number = NaN, totalTime : オプ ショ ン で ビデ オ の 再 
isgLi1ive : Boolean = falgse 生 時 間 を 示し ます 。 


isLive : ラ イブ スト リー ム の 場合 、 true 
に し ます 。 


) :VO1d 


FLVPlayback コン ボー 


き FLVPlayback クラ ス の 主 な メソ ッ ド 概要 (続き ) 





アー あー 








目的 メソ ッ ド 名 











ネン ト で ビデ オ を 再生 する 








再生 を 一 時 停止 する pause ( ) : 











メ メソ ッ ド の 概要 


ビデ オス トリ ー ム の 再生 を 一 時 停止 
し まま 。 














| 再生 を 開始 する p1a 
| SOUYCG : 6 上 1mq = ul] , 
totalT ュ 1me : Number = NaN, 
1SLi1Ve : Boo]ean = fa]se 
・ ざ 〇 1Q 
シー ク す る SeekK ( 上 1me : Number) : 
再生 を 停止 する 8tOD () : 














ビデ オス トリ ー ム を 再生 し ます 。 








1 ァイル 内 の 指 定時 間 ( 秒 単位 を 小数 
点 以 下 3 杵 まで の 精度 (ミリ 秒 精度 ) で 
| シー ク し ます 。 





| ビデ オ の 再生 を 停 上 し ます 。 











草 FLVPlayback ク ラス の 主 な イベ ント 











タイ ミン グ | イベン ト を 











5 








イベ ント の 概要 に _ 











| 再生 が 完了 し た Comp]ete 
| (定数 VideoEvent.COMPLETE) 





ーー 


























| レー ゼー が FLV フ ァ イル の 最後 に 到達 し 


て 再生 が 完了 し た と き に 送出 され ます 。 























ダグ ウ ン ロ ー ド 状況 が 更 | progresg 進捗 状況 は ダウ ン ロ ー ド し た バイ ト 数 で 
新 さ れ た (定数 VideoProgressEvent 表 さ れ ま す 。 
PROGRESS) 
| FLV フ ァ イル が ロー ド | ready FLV フ ァイル が ロー ド さ れ 表 示 準 備 が で き 
| され 表示 準備 が で きた | (定数 VideoEvent.READY) た と き に 送出 され ます 。 
| 再生 ヘッ ド の 位置 が 変 | seeked seek() の 呼び 出し 、playheadTime プ ロ パ 
更 さ れ た (定数 VideoEvent.SEEKED) ティ の 設定 、 ま た は SeekBar コ ント ロー ル 
の 使用 に より 、 再 生 ヘ ッ ド の 位置 が 変更 











どれ た と き に 送 き 出 され ます 。 














こら プッ 7 < と 7m こ > ュー 1 
ラ VideoSampleA_.swf UI 、X 。」 | 
ファ イル (F) 表示 (V) 詩 卿 (CO デバ ッ グ (D) | 


Adobe AR Pe 


トート リア ルビ アオ 


導入 綿 








] 





語 訓 軸 ヨ 紅 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
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9- 
に 


AMPLE ビ ロ ロ FE EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 


FLVPlayback を 使う VideoSampleA.jla 


1mport F] . ゞ 1deo .V1deoPrOdreGS8EiVer : 
PART 1mport FfF] . ゞ 1deo .V1deOEVer : 


var Y1deoURL : String = "Vi1deos/ sampleFLV .F1Y": 


Function init() :vo1d { 
F]vp]ayback . addEventListener ( V1deoProdre88EVen . PROGRESS , V1Qdeo 
Prodre88 ): 
f]vp]ayback . addEventLigstener ( VideoEvent .READY, videoReady ): 
FlvP]ayjback . addEventListener ( VideoEvent . SEEKED, Y1deoSeeked ): 
ftyPlayback . 1oad (Y は deoURL) : 一 ーーーーーーーーーーーーーーーーーーー デ ーーーーー① 
) 
Fumoction videoProgresg (event : VideoProgressEvent ) :Vo1d ( 
trace( event .bytesTota1l + " 中 "+ event.bytesLoaded + " バイ トロ ー ド 完了 " 
) ② 





明良 、 
Function videoReady (event : VideoEvent ) :void { 
trace ( "再生 の 準備 が で きま し た 。 ソ ー ス ビデ オ サ イ ズ : 縦 =" + 
F]vp]aybaock .preferredHeight + ③ 
! 。 横 =" + E1vP]layback .preFerredW1dth ): 


) 
Funoction videoSeeked (event :VideoEvent ) :vo1d { 
trace ( "再生 ヘッ ド 位 置 が 変わ り ま し た 。state=" + event.state ): (④ 
) 
1n1 () : 


FLVPlayback コ ン ポ ー ネ ン ト を 使用 する と 、 単 に ビデ オ を 再生 する 場合 は ほとん ど プ ログ ラ 
ミン グ な し に 行う こと が で きま す 。 デ ザイ ン モ ー ド で コン ボー ネン ト の source を 指定 し て いな 
い 場 合 、 ま た は 動 的 に 再生 する ビデ オ を 変え る 場合 は 、① で 行っ て いる よう に 、load0 メ ソ ッ 
ド で ファ イル 名 を 指定 し ます 。 サ ー バ ー か ら ロ ー ド され る 状況 を 取得 する に は 、progress イ ベ 
ント を 使用 し ます 。② の よう に 、 ロ ー ド 済み バイ ト 数 を 取得 で きま す 。 ロ ー ド が 完了 し 、 再 生 
の 準備 が 整う と 、ready イ ベン ト が 発生 し て 、③ の よう に 処理 で きま す 。 ま た 、 ビ デオ の 再生 
位置 が 変化 し た 場合 、seeked イ ベン ト が 発生 し て 、④ の よう に 情報 を 得る こと が で きま す 。 
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和孝 4【 り に 1d 引 り 吉 
リモ ー ト ビデ オ 再 生 を 行う 





ActionScript で ビデ オ の ロー ド 、 表 示 、 再 生 の すべ て を 制御 する こと が で きま す 。 外 部 ビデ 
オ を ロー ド す る 場合 、VWeb サー バー か ら フ ァイル を ロー ド し て プロ グレ ッ シ ブ ダウ ン ロ ー ド 
を 行 つ か 、Flash Media Server な どの 専用 サー バー か ら 配 信 さ れる スト リー ミン グ ビ デ オ を 
再生 する こと が で きま す 。AvctionScript で その よう な ビデ オ ソ ー ス を 操作 する 場合 、Net 
Connection ク ラス 、NetStream ク ラス 、Video ク ラス を 使用 し ます 。NetConnection ク ラ 
ス は サー ババ 側 アプ リケーション イン スタ ンス と の 接続 を 行い 、NetStream ク ラス が スト リー ミ 
ング を 行い 、 再 生 や 停 止 の 制御 を 行い ます 。 こ の と き 、1 つ の 接続 に 複数 の スト リー ム を 割り 
当て る こと が で きま す 。Video ク ラス は 表示 オブ ジェ クト の サブ クラ ス で 、 ス テー ジ 上 で 再生 
する ビデ オ の 表示 を 行い ます 。 ロ ー ド する ビデ オ の 情報 は 、NetStream ク ラス の client プ ロ パ 
ティ に 指定 する オブ ジェ クト に 、 コ ー ル バッ ク 関 数 を 設定 する と いう 方 法 で 取得 で きま す 。 コ 
ー ル バッ ク 関 数 の 種類 に つい て は 、 下 表 「NetStream ク ラス の client オ ブ ジ ェクト の プロ パ 
ティ (コール バ ッ ク 関 数 用 )」 を 、 使 用 方 法 に つい て は 、 サ ンプ ルコ ー ド を ご 覧 くだ さい 。 サ ン 
プル コー ド で は 、 プ ログ レッ シブ ダウ ン ロ ー ド に よる ビデ オ の 再生 を 行い ます 。 


きき ビデ オ の ロー ド と 再生 を 制御 する た め の ActionScript ク ラス 














NSR NN 8 | 
クラ ス | 概要 
の 2 NM Ns 
flash.net スト リー ミン グ サ ー バ や Web サ ー バ と クラ イア ント 間 の デー タス トリ ー ム を 構築 








NetConnection | する ベー ス と な る 接続 を 提供 し ます 。 

















flash.net. NetConnection オ ブ ジ ェクト に より 接続 され た スト リー ミン グ サ ー バ と の コネ クシ ョ 


NetStream ン 上 の チャ ネル と し て 、 ス トリ ー ミ ング 接続 を 開き 、 メ ディ ア の 再生 を 制御 し ます 。 





ー 十 


flash.media. | Video ク ラス の イン スタ ンス は ステ ー ジ 上 の ビデ オ コ ン テン ツボ ックス と し て ライ 








Video ブ ビ デオ や ビデ オフ ァイル を 再生 表示 し ます 。Video ク ラス は DisplayObject の サ 
ブ プク ラ ス で ある た め 、 配 置 や 変換 、 フ ィ ル ター の 適用 、 ブ レン ドモ ー ド な ど を 使用 








し て 操作 で きま す 。 











筆 NetConnection クラ ス の 主 な プロ / \ テ ィ 概 要 


目的 」 プロ バテ ィ 名 「 プロ パテ ィ の 概要 、 


サー バー へ の 接続 方 法 を 調べ | connected [読み 取り 専用 ] 永続 的 な RTMP 接 続 を 介し て 
る | :Boolean (true)、 ま た は それ 以外 の 方 法 で (false) サ 
ー バ に 接続 され て いる こと を 示し ます 。 

NetConnection イ ンス タン ス | protocol :Strind | この NetConnection イ ンス タン ス の オブ ジェ 
の AMF バ ー ジ ョ ン を 設定 する クト エン コー ド (AMF バ ー ジ ョ ン ) を 表し ます 


接続 プロ トコ ル を 調べ る 











































ーーーー サ ーーーーーーー 一 一 








o1:Strind | [読み 取り 専用 ] Flash Media Server と の 接 
続 プ ロト コル を 表し ます 。 


接続 失敗 時 の 代替 手段 を 指定 | proxyType サー バ へ の 初期 接続 に 失敗 し た 場合 に 実行 す 
する : Str1nd る 代替 手段 を 指定 し ます 。 


ビー マツ 
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息 NetConnection クラ ス の 主 な メソ ッ ド 概要 






















アプ リケーション サー バー 上 の | cet ユ 1【 Flash Media Server 上 また は Flash Remoting 
メソ ッ ド を 呼び 出す command : String, | 実行 し て いる アプ リケーション サー バ 上 の コ 
re8DOnder : マン ド ま た は メソ ッ ド を 呼び 出し ます 。 
Re8ponQder , 
. ardumen8 


) : ざ O1d 



















ロー カル で 開始 し た 接続 また は サー バ へ の 接 
続 を 閉じ 、NetConnection.Connect.Closed 
を code プ ロ パ ティ と し て 、netStatus イ ベン 
ト を 送出 し ます 。 


Flash Player ま た は AIR ア プリ ケー ショ ン と 
Flash Media Server ア プリ ケー ショ ン 、 ま た 
は Web サ ー バ と の 間 に 接 続 を 作成 し ます 。 


実行 され て いる すべ て の Net | c1ose () : void 
Stream オ ブ ジ ェクト を 切断 


する 




















Connec ( 
Command : S 上 エエ 1nd , 
。 ardumen8 
) : Vo1d 


サー バ と 接続 する 





待 NetConnection クラ ス の 主 な イベ ント 


ステ ー タ ス ま た は エ | netStatug NetConnecttion オ ブ ジ ェクト が 、 そ の ステ ー タ ス 
ラー が 送出 され た (定数 NetStatusEvent. また は エラ ー の 状況 を レポ ー ト する と き に 送出 さ 
NET STATUS) れれ ます 。 


NetConnection.call() の 呼び 出し に よっ て 呼び 出 
し 元 の セキ ュ リ ティ サン ド ボ ッ クス の 外部 に ある 
サー バ に 接続 し よう と する と 送出 され ます 。 



























CuU エ 1 ユ 七 EE エ エ O エ 
(定数 SecurityErrorEvent. 
SECURITY_ERROR) 


ギュ リリ ディ ラー 
が 発生 し た 










華 NetStream クラ ス の 主 な プロ パティ 概要 


コー ル バ ッ ク メ ソ ッ ド が 呼び 出 FLV の スト リー ミン グ や プロ グレ ッ シ ブ ダウ ン ロ ー 
され る オブ ジェ クト を 指定 する ド の 処理 に コー ル バ ッ ク メ ソ ッ ド が 呼び 出さ れる オ 
ブ ジ ェクト を 指定 し ます 。 


C」] ien 
: Ob] ec 

















馬 NetStream ク ラス の 主 な メソ ッ ド 概要 


マイ クオ ー デ ィ オ 入力 | attachAudio( microphone で 指定 され る Microphone オ 
を Flash Media miorophone :Microphone | ブ ジ ェクト か ら NetStream オ ブ ジ ェクト を 
Server に 送信 する ) : vo1d 介し て 送信 され る オー ディ オス トリ ー ム を 
指定 し ます 。 


カメ ラ か ら ビ デオ の キャ プチ ャ を 開始 し ま 
す 。theCamera が null に 設定 され る と 、 キャ 
プチ ャ を 停止 し ます 。 





































at 上 tachCamera ( 
theCamera : Camera, 
SnapShotM1]11SeConQd8 : 
1n 七 = -1) :VoO10d 


7 基 プ キャ グチ ヤール 
力 を Flash Media 
Server に 送信 する 








9- 分 
ActionScript で リモ ー ト ビデ オ 有 再生 を 行う 


ト う 


名 NetStream ク ラス の 主 な メソ ッ ド 概要 (続き ) 


スト リー ム 再 生 を 停止 | c1ose () :void スト リー ム 上 の すべ て の デー タ の 再生 を 停止 
し て 開放 する し 、time プ ロ パ ティ を 0 に 設定 し 、 他 の 用 途 
で スト リー ム に アク セス で きる よう に し ます 。 


スト リー ム 再 生 を 一 時 | pause () :void ビデ オス トリ ー ム の 再生 を 一 時 停止 し ます 。 

停止 する 

メデ ィ ア を 再生 する play ( . . . ardument8 ) FLV、F4V、MP3 な どの メデ ィ ア ファ イル 
vo1d を 再生 し ます 。 


スト リー ミシン シグ オー ディ | ロ mb1 ah ( クラ イア ント か ら Flash Media Server へ 、 
オ 、 ビ デオ 、 テキ スト を | name : String = か りー スン が オー ディ イオ ル 、 羽 デ オ 、 おま 
Flash Media Server er St 上 エ 1nd = nu]11 び テ キス トメ ッ セ ー ジ を 送信 し ます 。 

に 送信 する : VO1d 


スト リー ム 再 生 を 再開 | resume () :void 再生 を 一 時 停止 し て いた ビデ オス トリ ー ム 
する を 再開 し ます 。 


スト リー ム を シー ク す る | seek (offFset : Number ) offset で 指定 され た 位置 に も っ と も 近い キ 
vo1d ー フ レー ム を シー ク し ます 。 









































息 NetStream ク ラス の 主 な イベ ント 






イベ ント の 概要 


入出 力 エ ラー が 発生 し て ネッ トワ ー ク 処理 が 
失敗 し た と き に 送出 され ます 。 












1 OE エ エ O エ 
(定数 IOErrorEvent. 
IO_ERROR) 


ネッ トワ ー ク 処理 が 失敗 し 
た と き 

















ステ ー タ ス ま た は エラ ー の | netStatug 
状態 を レポ ー ト し た と き (定数 NetStatusEvent. 
NET STATUS) 


NetStream オ ブ ジ ェクト が 、 そ の ステ ー タ ス 
また は エラ ー の 状態 を レポ ー ト する と 送出 され 
ます 。 






符 NetStream ク ラス の client オ ブ ジ ェクト の プロ パテ ィ ( コ ー ル バッ ク 関 数 用 ) 


ビデ オ に 埋め 込ま れ た 記述 再生 中 の ビデ オ に 埋め 込ま れ た 記述 的 情報 を Flash 


的 情報 を 受け 取っ た と き Player が 受け 取っ た と き に 応答 する リス ナー を 定義 
スト リー ム の 再生 が 終了 し | onP1ayStatus 
た どき 


し ます 。 
メデ ィ ア ファ イル に 提 め 込 






















1 
| 
が 













Flash Player が 再生 中 の メデ ィ ア ファ イル に 埋め 込 
まれ た テキ スト デー タ を 受信 し た と き に 応答 する リ 
スナ ー を 定義 し ます 。 


NetStream オ ブ ジ ェクト に よる スト リー ム の 再生 が 
終了 し た 場合 に 応答 する リス ナー を 定義 し ます 。 
信 し た と き 
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F 


ー ア 1 敵 コ 


| 圭 | VideoSampleB.swf 


| | ファ イル (E) 表示 Cy) 竿 御 ( 〇 ) 


PARI 





ニア 1 | 半 コ 間 mm jp】 コ 





デバ ッ グ (D) 








プロ グレ ッ シ ブ ダウ ン ロ ー ド に よる ビデ オ 再 生 を 行う 


1mDOr 
科 # 1mDOr ヒ 
1mDOr ヒ 
1mDOr ヒ 
1mDOr キ 
1mDOr 


1mDOr キ 上 


Flagsh. 
Flagh . 
Flagh . 
Flagsh. 
Flagh . 
Flash. 
Flash. 


display . SDr ユ 6: 
eVent8 . Net 上 St 上 Latu8EVeri : 
eVen 8 . SeCU エ 1 ユ 上 EE エエ OTEVGT : 
media .V1deo: 

ne .NetConnec1OnT : 

ne .Ne ヒ S ヒ ea 


VeGn8 .EVGn 七 : 


// ロ ー ド する ビデ オフ ァイル 


Var ゞ 1deoURL : SLr1nq= "1deog/ gampleFLV .F1Y リ : 


Ya Connection : NetConnect1on : 


Va 8 ヒエ eam : NE 上 お ヒエ GaTm 


/ /NetConneoct1on 接 続 を 行 つ 処理 


Function init() { lp RI ーー 


COnnmeC 七 1 の On 


= mew NetConnect1on ( ) : 


/ / ス テー タス 、 エ ラー 時 の イベ ント ハン ドラ 登録 


ビデ オ コ ン テン ツ 


conneotion . addEventL1stener (NetStatusEvent .NET STATUS, neStaU8) : 


/ / セ キュ リティ エラ ー 時 の イベ ント ハン ドラ 登録 


connect ion . addEventist 上 ener (SeCu エ 1t 上 YE エエ OrEVent . SECURTTY ERKOR , 


netConmecCt1OnSGCu エ 1 上 YE エエ C エ ) 』 
/ / サ ー バ ー と 接続 


Connect ュ on . Connect (mu) : 


370U 


9-3-2Z 
ActionScript で リモ ー ト ビデ オ 有 再生 を 行う 


/ / セ キュ リティ エラ ー 時 の イベ ント ハル ンド ラ 
FumcCt1on netConmect1OnSGCu エ 1 上 YE エエ Or (eVent : SeCu エ 1EyE エ roOrEVent ) :Yo1d 1{ 


trace ( "セキ ュ リ ティ エラ ー が 発生 し まし た 。: " + event .toStrinqd() ): 


/ / ス テー タス 、 エ ラー 時 の イベ ント ハン ドラ (NetConnection , NetStream 共 通 ) 
Funotion netStatugs (event : NetStatugEven ) :o1d { 一 ーーーーーーーーーーーーー ②) 
// ス テー タス の 内 容 を 判定 
trace (event . infFo.Code ) : 
gw1toh (event . info.code) { 
/ / 接続 成功 
Ca8e "NetConnect1on . Connect .Sucocesg『" 
trace ( "NetConnect1on 接 続 に 成功 し まし た 。" ): 
qetStream ( ) : 
break : 
/ / 接続 失敗 
Ca8e "NetStream . Play .StreamNotFound!" : J 
trace ( "NetStream 接 続 に 失敗 し まし た 。 『" + ゞ ideoURL) : 
breaK : 
/ / そ の 他 の ステ ー タ ス / エ ラー 
defau」lt : 
sw1tch (event . info.1eve] ) { 
Ca8e "8Eau8" 
traoe ( "その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=" + 
evert . 1nfo.Code ): 
breaKk : 
Ca8G "と エエ OF" 
trace ( "その 他 の エラ ー が 発生 し まし た 。code=" + event .info.code ): 
break : 


) 


break :: 


/ /NetS8tream の 処理 

Eunction getStream ( ) :YO1d { 一 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ③) 
/ /NetStream コ ンス トラ クタ に NetConnection オ ブ ジ ェクト を 渡す 
8tream=new NetStream (Conmect1Oon) : 
/ / ス テー タス 、 エ ラー 時 の イベ ント ハン ドラ 登録 


gtream . addEventL1istener (NetStatusEvent .NET STATUS, netStatu8) : 371 


PART 


さて 


// コ ー ル バッ ク メ ソ ッ ド 用 オブ ジェ クト 

Yar C+1ient :Ob]eoct = new Ob]ect () : 

c1ient .onMetaData = hs .onMetaData: 

c1ient .onCuePoin = th18 .OonCuePo1n : 

gtream .C11ent = Cl]ien : 

/ / 表示 用 の Video オ ブ ジ ェクト 

Yar Y1deo:V1deo = new Video(): 

//NetStream と 関連 づけ る 

ゞ Yideo . at 上 tachNetStream (Stream) 』 

gtream . play (V1deoURL ) : 

addChi1d (1deo) : 

/ / 一 時 停止 、 再 生 、 停 止 を 行う 関数 の 登録 

reSume mc.addEventL1stener (MouseEvent .CLTCK, re8ume エ ) : 
pau8e mo.addEventListener (MouseEvent .CLhTCK, Dau8e エ ) : 


8top mc.addEventL1stener (MouseEvent .CLTCK, stODp エ ) : 


/ / コ ー ル バッ ク メ ソ ッ ド 

Function onMetaData (info:Ob]jeoct ) :void { 
trace ( "コー ル バ ッ ク メ ソ ッ ド (metadata) : durat1on=" + info.durat1ion + " 
w1dth=" + info.width + " he1ight=" + info.he1iqght + " framerate=" + 
1nfFo . Framerae) : 

) 

Funotion onCuePoint (info:Ob]ject ) :vo1d { 
trace ( "コー ル バ ッ ク メ ソ ッ ド (cuepornt ) : 上 1me=" + 1nfO.E 上 1me + " name=" + 


infFo.name + " tyDe=" + 1nfEo.tyPG@) : 


/ / 一 時 停止 、 再 生 、 停 止 を 行 つ 処 理 関数 

Funotion resumeTt (event : Even ) :Yo1d { 
8 上 ream . reGSUume () : 

) 

Funotion pauseTt (event : Event ) :void {1 
8 上 ream . DauSe ( ) 

) 

Funotion stopTt (event : Event ) :vo1d 1 
8 上 ream . DauSe ( ) : 
8tream.Seek( 0 ): 


) 


ま 基 半 も 【) 』 


9-3-Z 
ActionScript で リモ ー ト ビデ オ 再 生 を 行う 


りか ら の init0 関 数 で NetConnection 接 続 を 行い ます 。② か ら の ステ ー タ スイ ベン ト ハ ンド 
ラフ で 接続 成功 、 エ ラー を 判定 で きま す 。 こ の ハン ドラ は NetStream の ステ ー タ スハ ンド ラ と 共 
通 で す 。NetConnection が 成功 する と 、3 か ら の getStream() 関 数 に より 、NetStream の 処 
理 を 行い ます 。 こ こ で は 、metadata、cuepoint に 対す る コー ル バ ッ ク 関 数 オブ ジェ クト の 設 
定 を 行い 、 表 示 用 の Video オ ブ ジ ェクト を 作成 し た ら 、play() メ ソ ッ ド を 呼び 出し て 再生 を 行 
いま す 。 有 再生 の コン トロ ー ル は ④ で 行っ て いる よう に 、NetStream オ ブ ジ ェクト の メソ ッ ド で 
行い ます 。 


> 実行 結果 (出力 例 ) 


NetConmec ュ on . Connect . Succesg 

NetConmect ュ on 接続 に 成功 し まし た 。 

NetStream . P] ay . St 上 ar 

て の 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream . Play . Start 

コー ル バ ッ ク メ ソ ッ ド (metadata) : duration=100 .84426303854875 width=655 
he1qght=480 fFramerate=undefined 

コー ル バ ッ ク メ ソ ッ ド (metadata) : duration=100.8 width=655 he1gh=480 Framera 
e=29.970016479492188 

NetStream . BuETer . Empty 

て その他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream .BuffFer .Empty 
NetStream . BufFFer .Fu11 

て の 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream . BuffFer . Fu] 1 


紅 48 刈 軸 表 護 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ニ ーー ニー ニーーーー ニ ーーーーーーー ニ ーー ニー ニー ニニ ニ ーー ニニ ー ニ ーー ニー 


馬 VceoSamplec - Mozilla Firefox MEI メ X 
ファ イル (E) 揚 集 (E) 表示 (y) 必 歴 (S) ブッ クマ ー ク (B) ツー ル T) ヘル プ (H) 

< で -: 議 - ーー 占 o+ http:/localhost/yideoSampleC.html | AsyncErrort 

| Google カ .… 『v flashxte..… 『「、 fash.net.… 詩 Adobe Ac.. 7 Adobe Fi 『「、 as3_devg.… AdobeFl. 箕 








AdobeAIR 台 


を 


"すき 
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ビデ オガ 


AMPLE ピロ ロ E 琴 EEEEEEEEEEEREREEEEEEEEEEEEEEEEEEEEEEEEEEELki 


スト リー ミン グ に よる ビデ オ 有 再生 (FMS3 で 確認 ) VideoSamplet.la 


1import flash .display .SDr1te: 

PART import fl]ash . events . NetStatuSEVGT : 
1mport FfF]agh . events . SeCu エ 1tYE エ TOrEVeT : 
1mport Flash .med1a .V1deo: 
import f1agsh .net .NetConmeC1On: 
1mpor 上 Flash .net .NetStream: 
1mport Flash . even8 . EVer : 


// ス トリ ー ミ ング サー バ URL と ロー ド す る ビデ オフ ァイル 名 

yar serverURL,: Strinq= "rtmp : / / 1oca1host/vVod" : 
var VideoFi1e : St 上 r1nqd= "sampleFLV" : 

var Connection : NetConmec1O: 


ゞ Ya 8Lream : NGt 上 S エ eam: 


/ /NetConnection 接 続 を 行 つ 処 理 

4) function nit() { 

connectiom = new NetConmect1on () : 

// ス テー タス 、 エ ラー 時 の イベ ント ハン ドラ 登録 

connection . addEventListener (NetStatusEvent .NET STATUS, netStaEu8) : 
// セ キュ リティ エラ ー 時 の イベ ント ハン ドラ 登録 

connection . addEventTiistener (SecurityErrorEvent . SECURTTY ERROR, netCOnmec 
tionSeCu エ 1tYErTC) : 

/ / そ の 他 の エラ ー 時 の イベ ント ハン ドラ 登録 

connection . addEventTListener (ASymCErrOrEVent .ASYNC ERROR, 
netArotherE エ TC) : 

connection .addEventListener (TOErrorEvent . TO_ ERROR, netAmotherEr エ C) : 
// コ ー ル バッ ク メ ソ ッ ド 用 オブ ジェ クト 

var Client :Ob]ect = new Ob]ect () : 

c1]ient . onBWDone = th18 .OnBWDOne : 

c]1ient . onBWCheck = thig .onBWcheck: 

conmection .C]1ien = client : 

/ / サ ー バ ー と 接続 


connect ion . connect ( serverURL) : 


// セ キュ リティ エラ ー 時 の イベ ント ハン ドラ 


Function netConnectionSecurityError (event : SeCu エ 1tyErrOrEVen ) : マ oO1d ( 
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ダー ラー ズ 
ActionScript で リモ ー ト ビデ オ 再 生 を 行う 


traCe ( "セキ ュ リ ティ エラ ー が 発生 し まし た 。: 『 + eVent .toString() ): 


) 


/ / そ の 他 の エラ ー ハ ンド ラ 
funct1on netAnotherError (event : Event ):void { 
trace ( "その 他 の エラ ー が 発生 し まし た 。: 『 + evert . toStrinq() ): 


// ス テー タス 、 エ ラー 時 の イベ ント ハン ドラ (NetConnection , NetStream 共 通 ) 
fumct1on netStatus (event :NetStatusEvent) :void { 
// ス テー タス の 内 容 を 判定 
traoCe (eVert . info . code) : 
Switch (event . info.code) { 
/ / 接続 成功 
Case "NetConmect1on .Connect . Succesg8" : 
trace( "NetConneotion 接 続 に 成功 し まし た 。" ) : 
Conmec ュ on . Ca11 ( "checkBandwidth" , nu11) : 
getStream( ) : 
break : 
/ / 接続 失敗 
Case "NetStream.Play.StreamNotFound!" : 
trace ("NetSEream 竣 続 に 失敗 し まし た 。 " + serverURL) : 
break : 
// そ の 他 の ステ ー タ ス / エ ラー 
default : 


前 





Switch (event . info.1eve] ) { 
Ca8e "StaEtu8 リ " : 
trace ("その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=" + event .1info.code ): 
breaKk : 
ーー らら: 0 人 
Erace ("その 他 の エラ ー が 発生 し まし た 。code=" + event . info.code )。: 
Dreak: 


了 


Dreak : 


/ /NetStream の 処理 


Funotion getStream ( ) :vo1d 1 


2 


/ /NetStream コ ンス トラ クタ に NetConmect ion オ ブ ジ ェクト を 渡す 
gtream=new NetStream (Conrmec1on) : 
// ス テー タス 、 エ ラー 時 の イベ ント ルン ドラ 登録 
PART gtream . addEyentLiistener( NetStatusEvent .NET STATUS, netStatU8) : 
stream. addEventLiistener ( AsyncErrorEvent .ASYNC ERROR, netAnotherErrOr ): 
stYeam .addEventListener ( TOErrorEvent . TO ERROR, netArotherErrOr ): 
// コ ー ル バッ ク メ ソ ッ ド 用 オブ ジェ クト 
var client :Ob]ect = new Ob]ect () : 
c]ient .onMetaData = て this .onMetaData: 
c]ient .onCuePoint = this .onCuePotnt : 
gtream . で Cien = Cl1tert : 
/ / 表示 用 の Video オ ブ ジ ェクト 
Yar Y1deo:Video = new V1deo() : 
video .w1dth = 400: 
video .he1qht = 300: 
V1deo.x = 10: 
v1deo.Y = 10: 
し / /NetStream と 関連 付け る 
yideo . attachNetStream (Stream) : 
gtream .p1ay (V1deoF11e) : 
addChi1d (Video) : 
// 一 時 停止 、 再 生 、 停 止 を 行う 関数 の 堂 録 
resume moc.addEventLigstener (MouseEVvent . ChTCK, reSUmeT) : 
pause mc.addEventListener (MouseEvent .CLhTCK, pau8e+ ヒ ) : 
stop moc.addEventListener (MouseEvent .CLTCK, stopT) : 


// コ ー ル バッ ク メ ソ ッ ド 
Function onMetaData (info :Ob]ect) :void { 
trace ("コー ル バ ッ ク メ ソ ッ ド (metadata) : duration= リ " + info.duration + " w1dth=" + 
info.width + " height=" + info.he1ght + " tramerate=" + 1info. Framera@) : 
) 
function onCuePoint (info:Object) :void { 
trace ("コー ル バ ッ ク メ ソ ッ ド (cuepoint ) : 上 1me=" + imfo.time + !" name=" + 1nfEO. 
name + " type=" + 1nfo.tyDe) : 
) 
function onBWDone ( . . .rest) :vo1d { 
Var Dw :NUumlDe エ : 
if (rest.1ength>0) { 
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9-3-2 
ActionScript で リモ ー ト ビデ オ 再 生 を 行う 


bw=res [0] : 
trace ( "コール バッ ク メ ソ ッ ド (bandwidth) bandwidth= " + bw +『 Kpps.") : 
) 
) 


fumcton onBWCheck ( . . . res) :Number { 


returTi 0: 


/ / 一 時 停止 、 再 生 、 停 止 を 行う 処理 関数 

Funotion resumeTt (event : Event ) :vo1d { 
8tream . YeGSUme ( ) : 

) 

funct1on pauseTt (event : Event ) :void 1 
8tream .Dau8e ( ) : 

) 

Function stopTt (event : Event ) :void { 


8tream .Dau8e ( ) : 3 


8tream.Seek( 0 ): 


1n1t () : 


実行 結果 (出力 例 ) 


NetConnection . Connect . Sucoegg 

NetConnect ュ on 接続 に 成功 し まし た 。 

NetStream . Play .Rese 

その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream. Pl1ay .Reset 
NetStream . Pl ay . 6 上 ar 

その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream.P1ay . Start 
NetStream . BufFfFer . Fu] 1 

その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream.BufFfer. Fu] 1 
コー ル バ ッ ク メ ソ ッ ド (metadata) : duration=37.637 width=656 he1qht=480 framera 
te=29.970016479492188 

NetStream . PauSe . NO1fFy 

その 他 の ステ ー タ スイ ベン ト が 発生 し まし た 。code=NetStream . Pauge . Not ュ fy 
NetStream . Buffer .F]ush 
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AnimatorFactory フ ラス 


メソ ッ ド 
' addTarget 






Motion ト ゥ イー ン を 表示 オブ ジェ ク ト に 適用 


238 241. 





と 45 








AnimatorFactory 


Motion オ ブ ジ ェクト を 関連 付け る 





238 
































































































































































































































































































































プロ バテ ィ 
length 配列 の 要素 数 を 得る 72 
メジ ッ ド 
filter フィ ルター を が ける 73 76 
forEach - 各 要素 に 対し て 関数 を 実行 する 73 
pop 最後 の 要素 を 取り 出し て 削除 する - 
push 最後 に 要素 を 追加 する 7 
『eVerSse ' 要素 の 並び を 反転 させ る 73 
shift 先頭 の 要素 を 取り 出し て 削除 する 吾 
sort ソー ト す る - 73 
splice 要素 を 追加 / 削 除 す る 7 
unshift 先頭 に 要素 を 追加 する 73 
toStrind 要素 を すべ て 文字 列 に する 73 
プロ パテ ィ 
bitmapData ピク セル デー タ を 処理 する た め の BitmapData オ ブ ジ ェクト を 参照 する 303 
_pixelSnapping も っ と も 近い ピク セル に 吸着 させ る 303 
smoothing 拡大 縮小 時 に スム ー ジ ング させ る 303 
メソ ッ ド 
Bitmap Bitmap オ ブ ジ ェクト を 作成 する 303 
プロ パテ ィ 
height イメ ー ジ の サイ ズ を 調べ る 308 
rect イメ ー ジ を 表す 息 形 オブ ジェ クト を 取得 する 308 
transparent イメ ー ジ が 透明 度 を サポ ー ト する か 調べ る 308 
メソ ッ ド 
applyFilter フィ ルター オブ ジェ クト を 適用 する 308 324 
clone ビッ トマ ッ プ の コピ ー を 作成 する 310 315 
copyPixels ビッ トマ ッ プ の 一 部 の コピ ー を 作成 する 310 
disDOse ビッ トマ ッ プ の メモ リ を 解放 する 310 
draw ビッ トマ ッ プ イメ ー ジ 上 に 描画 する 309 317 
fillRect 息 形 領域 の ビク セル を 塗り つぶ す _309 
floodFil 塗り つぶ し 処理 を 行う 309 
_generateFilterRect applyFilter メ ソ ッ ド に よっ て 影響 を 受け る 乱 形 を 調べ る 308 
getPixel 特定 ポイ ント の RGB ピク セル 値 を 調べ る 「 310 311 
getPixel32 特定 ポイ ン ト の ARGB ピ クセ ル 値 を 調べ る 310 311 
getPixels 息 形 領域 か ら バ イト 配列 を 作成 する 310. 31 
_hitTest 他 の ビッ トマ ッ プ や オブ ジェ クト と の 接触 を 調べ る 。 30 











INDEX 





noise ラン ダム ノイ ズ で 塗り つぶ す 309 
perlinNoise Perlin ア ル ゴ リ ズム で 自然 に 見 える ラン ダム ノイ ズ を 適用 する 309 
pixelDissolve ピク セル ディ ゾル ブ を 実行 する 309 
Scro イメ ー ジ を スク ロー ル す る 
setPixel 1 ビク セル の カラ ー を 設定 する 309 
setPixel32 1 ビク セル の カラ ー と アル ファ を 設定 する 310 
setPixels バイ ト 配 列 を 短 形 領域 の ビク セル デー タ に 変換 する 310 311 
ーーーーーーーーーーーーーーーーーーーーーーーーー プ ーー 
hasIME 現在 の シス テム に IME が イン スト ー ル され て いる か 調べ る 129 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーO 555 
音 や OTENTETIFNTN ミ 7 ミ え ミ 5,5<5= ミ S3 え 3 ヽ る h9「Y「[6 レ リッ ーー! 
date 月 の 日 付 を 表す 52 
day 曜日 を 数 値 で 表し ます 0 が 日 曜日 を 表す 52 
fullYear 4 桁 の 年 52 
hours 時 間 を 0 一 23 の 数 値 で 表す 52 
minutes 分 を 0 一 59 の 数 値 で 表す 52 
month 月 を 表し ます 52 
seconds 秒 を 0 一 59 の 数 値 で 表す 52 
メソ ッ ド 
qetTime 1970/1/1 0:00(UTC) か ら の ミリ 秒 数 を 返す 54 
ーーーーーーーーーーーーーーーーーーーーーーーーーー ーッ ヤヤ ハヤ ハ へ ね や ね や や や ヤ や ハハ や ね 
プロ パテ ィ に 「 
alpha 透明 度 ( ア ルフ ァ 値 ) を 取得 / 設 定 177 186 
blendMode 育 景 オ ブ ジ ェクト と 重なっ た 部 分 の ブレ ンド モー ド 177 186 
cacheAsBitmap 復 雑 な ベク ター 画像 の 表示 速度 を 上 げ る 177 186 
opaqueBackground 177 186 
filters フィ ルター を 関連 づけ る 177 321 
height オブ ジェ クト の 高 さ / 幅 を 取得 / 設 定 する 178 183 
width 178 183 
loaderInfo SWF フ ァイル 、 画 像 ファ イル の 読み 込み 情報 を 取得 する 179 
mask オブ ジェ クト に マス ク を か ける 177 186 
mouseX マウ スポ イン タ の 座標 を 取得 する 178 
mouseY 178 
parent 親 の 表示 オブ ジェ クト コン テ ナ 参 照 を 取得 する 178 
root ルー ト の 表示 オブ ジェ クト コン テ ナ を 取得 する 178 
rotation オブ ジェ クト を 2D 回 転 する - 178 183 
rotationX オブ ジェ クト を 3D 回 転 す る 178 183 275 
rotationY 178 183 275 
rotationZ 178 183 275 
scale9Grid オブ ジェ クト の 周囲 を 拡大 / 縮 小 用 に 調整 する 178 
scaleX オブ ジェ クト を 拡大 / 縮 小 す る 178 183 275 
scaleY 178 183 275 
ScaleZ 178 183 275 
scrollRect オブ ジェ クト の 表示 部 分 を トリ ミン グ す る 178 
stage ステ ー ジ オブ ジェ クト を 参照 する 178 
transform オブ ジェ クト の カラ ー を 調整 /2 次 元 /3 次 元 マ トリ ックス 変換 を 適用 177 275 
visible オブ ジェ クト を 表示 / 非 表示 に する 178 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーOOOOOOOOO5____- 
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X オブ ジェ クト の 位置 座標 を 取得 / 設 定 する 178 183 275 
y 178 183 275 
Z 178 183 275 

メソ ッ ド 
getBounds 表示 オブ ジェ クト の 領域 を 座標 で 取得 する 179 
getRect 179 
globalToLocal グロ ー バ ル 座 標 や ロー カル 座標 変換 する 179 
localToGlobal 179 
globalToLocal3D 179 276 
local3DToGlobal 179 276 
hitTestObject 他 の 表示 オブ ジェ クト と 重なっ て いる か 判定 する 179 
hitTestPoint ある 座標 と 接触 し て いる か 判定 する 179 

イベ ント 

added 表示 オブ ジェ クト が 表示 リス ト に 追加 削除 さ ぐれ た と き 180 
removed 180 
addedToStage 180 
removedFromStade 180 
enterFrame フレ ー ム レー ト の 時 間 間 隔 で 処理 を 行う 180 
exitFrame 180 


WuURKWKCUKCO わ OO リ め わ ウ め $sw ャ ww キャ キ pnwー ド ロ $ シ Bb ハ \ ハ ヽ ベ % ヽ る る #- ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
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プロ パテ ィ 

numChildren DisplayObjectContainer オ ブ ジ ェクト の 子 の 数 を 表す 221 
tabChildren Displa ObjectContainer オ ブ ジ ェクト が 持つ 子 オ ブ ジ ェクト が 205 

Tab に よる フォ ー カ ス を 受け る か 、 受 け な い か を 決定 する 

V ッ y ま ド 

addChild 表示 オブ ジェ クト を 追加 する 180. 222 
addChildAt 181. 222 
getChildAt 子 表示 オブ ジェ クト を 取得 する ーー 180 
getChildByname 180 
getChildIndex 子 表 示 オ ブ ジ ェクト の イン デック ス を 取得 する 180 222 
removeChild 子 表示 オブ ジェ クト を 削除 する 181. 222 
removeChildAt 181 222 
setChildIndex 子 表示 オブ ジェ クト の イン デック ス を 変更 する 180 
プロ バテ ィ 

alignmentBaseline ベー スラ イン を 指定 する 152 
backgroundAlpha 背景 の アル ファ 値 を 指定 する 152 
backgroundColor 背景 の 色 を 指定 する 

baselineShift ベー スラ イン を 移動 させ る 152 
blockProgression 垂直 / 水 平方 向 の 行 配置 を 指定 する 152 
breakOpportunity 改行 可能 位置 を 制御 する 152 
color テキ スト の 色 を 取得 / 設 定 する 153 
columnCount テキ スト 列 の 数 を 指定 する 153 
columnGap 列 間 の ふち 取り 領域 キャ ッ プ を 指定 する 153 
columnWidth 列 幅 を 指定 する 153 
digitCase 数 字 の 大 文字 小文字 タイ ブ を 指定 する 153 
digitVidth 数 字 の 幅 の タイ プ を 指定 する 153 
direction 左右 方 向 の 読み 順 を 設定 する 154 
dominantBaseline 行 エ レ メ ン ト の 垂直 座標 を 決め る ベー スラ イン を 指定 する 154 
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firstBaselineOffset 
fontFamily 
fontLookup 
fontSize 

fontStyle 
fontWeight 

format 

id 

justificationRule 
justificationStyle 
kerning 
leadingModel 
lineBreak 
lineHeight 
lineThrough 

locale 

paddingTop 
paddingBottom 
paddingLeft 
paddingRight 
paragraphStartIndent 
paragraphEndIndent 
paradraphSpaceBefore 
paradraphSpaceAfter 
parent 
renderingMode 
styleName 

tabStops 

textAlign 

textAlpha 
textDecoration 
textIndent 
textJustify 
textLength 
textRotation 
trackingLeft 
typodraphicCase 
verticalAlign 
whiteSpaceCollapse 
メソ ッ ド 

clearStyle 
deepCopy 
getNextSibling 
getParagraph 
getStyle 

getText 
getTextFlow 
setStyle 


最初 の 行 の ベー スラ イン 位置 を 指定 する 

フォ ント 名 を 取得 / 指 定 する 

フォ ント ルッ クア ッ プ を 取得 / 指 定 する 

フォ ント サイ ズ を 取得 / 指 定 す る 

フォ ント の 約 体 スタ イル を 取得 / 指 定 する 
フォ ント の ウェ イト スタ イル を 取得 / 指 定 す る 
フォ ー マ ッ ト を 指定 する 

id を 取得 / 設 定 する 

段落 テキ スト の 均等 配置 ルー ル を 取得 / 設 定 する 
段落 の 均等 配置 スタ イル を 取得 / 設 定 する 

カー ニン グ を 取得 / 設 定 す る 

行 送り モデ ル を 取得 / 設 定 する 

テキ スト の 折り 返し を 制御 する 

テキ スト の 行 送り を 制御 する 

打ち 消し 線 を 描画 する 

テキ スト の ロケ ー ル を 取得 / 設 定 す る 
コン テ ナ と テキ スト の 間 の スペ ー ス を 指定 する 


段落 の 始 端 / 終 端 の イン デン ト を 取得 / 指 定 する 
段落 の 前 / 後 ろ に 開け る スペ ー ス を 取得 / 指 定 する 


親 オ ブ ジ ェクト を 取得 する 

レン ダリ ング モー ド を 取得 / 設 定 する 

スタ イル 名 を 取得 / 設 定 する 

タブ スト ッ プ を 取得 / 設 定 する 

段落 内 の 行 揃え を 取得 / 設 定 する 

テキ スト の アル ファ 値 を 取得 / 設 定 する 

テキ スト の アン ダー ライ ン 装 飾 を 取得 / 設 定 する 
テキ スト の イン デン ト を 取得 / 設 定 する 

テキ スト の 均等 配置 オプ ショ ン を 取得 / 設 定 する 
テキ スト の 長 さ を 取得 する 

テキ スト の 回 転 を 取得 / 設 定 する 
文字 の 左 / 右 側 の トラ ッ キ ング を 適用 する 

文字 の 大 文字 小文字 区 別 の タイ プ を 取得 / 設 定 す る 
垂直 行 揃え と 均等 配置 を 取得 / 設 定 する 

イン ポ ボート 時 の 空白 文字 の 処理 を 指定 する 


スタ イル を クリ ア す る 

オブ ジェ クト の コピ ー を 作成 する ( 子 を 含む ) 

同じ タイ プ の 次 / 前 の FlowElement オ ブ ジ ェクト を 取得 する 
関連 付け られ て いる ParagraphElement オ ブ ジ ェクト を 取得 する 
指定 し た スタ イル の 値 を 取得 する 

エレ メン ト 内 の テキ スト 範囲 を 取得 する 

ルー ト TextFlow オ ブ ジ ェクト を 取得 する 

スタ イル を 適用 する 


INDEX 


154 
154 
155 
155 
155 
155 
155 
155 
155 
156 
156 
156 
157 
157 
157 
157 
157 
157 
157 
157 
157 
157 
158 
158 
158 
158 
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INDEX 


shallowCopy 


splitAtPosition 


オブ ジェ クト の コピ ー を 作成 する ( 子 を 稿 まな い ) 


オブ ジェ クト を 分 割 す る 


162 
162 











FLVPlayback プ ラ ス 
ブロ バテ 
mm 自動 再生 を 行う 364 
autoRewind 自動 巻き 戻し を 行う 364 
bytesLoaded ロー ド 済 み バ イト 数 を 取得 する 364 
bytesTotal 総 バ イト 数 を 取得 する 364 
height FLVPlayback の 幅 と 高 さ 364 
width 
isLive スト リー ミン グラ イブ 指示 を 行う 364 
playheadPercentage 再生 済み の パー セン ト を 取得 する 
playheadTime 現在 の 再生 位置 を 調べ る 364 
preferredHeight ソー ス FLV フ ァイル の サイ ズ を 調べ る 364 
scaleMode ロー ド し た ビデ オ の サイ ズ を 決め る 364 
SOUrCe FLV フ ァイル の URL を 指定 / 取 得する 364 
totalTime ビデ オ 再生 時 間 の 合計 を 取得 する 364 
volume ボリ ュー ムコ ント ロー ル 設 定 値 を 設定 / 取 得する 364 
メソ ッ ド 
enterFullScreenDisplayState フル スク リー ン 表 示す る 364 
load FLV フ ァイル の ロー ド を 開始 する 364 
Dause 再生 を 一 時 停止 する 365 
play 再生 を 開始 する 365 
seek シー ク す る 365 
stop 再生 を 停止 する 365 
イベ ント 
complete 再生 が 完了 し た と き 365 
DrOqreSS ダウ ン ロ ー ド 状況 が 更新 され た と き 365 
ready FLV フ ァイル が ロー ド さ れ 表 示 準 備 が で きた と き 365 
seeked 再生 ヘッ ド の 位置 が 変更 され た と き 365 
FocusManager ノ ラス 入 2 
プロ バテ ィ 半生 ) ORE 
defaultButton デフ ォ ル ト の ボタ ン を 設定 / 取 得する 208 212 
defaultButtonEnabled デフ ォ ル ト の ボタ ン が 有効 か 208 212 
メソ ッ ド 
activate FocusManager を アク ティ ブ / 非 アク ティ ブ に する 208 
deactivate 208 
FocusManager 管理 する 対象 の DisplayObjectContainer オ ブ ジ ェクト を 208 
指定 する 
getFocus フォ ー カ ス を 持っ て いる オブ ジェ クト を 調べ る 208 209 
getNextFocusMana Tab キ ー で 次 に フォ ー カ ス を 取得 する オブ ジェ クト を 調べ る 208 209 
gerComponent 208 209 
hideFocus フォ ー カ スイ ンジ ケー タ を 削除 / 表 示す る 208 
showFocus 208 
setFocus 指定 し た オブ ジェ クト に フォ ー カ ス を 移す 208. 209 
メソ ッ ド “ も 
enumerateFonts 現在 の 環境 で 使用 可能 な フォ ント を リス ト ア ッ プ する 127 
hasGlyphs その フォ ント に 指定 の 文字 が 含ま れ て いる か 判定 する ーー 127 
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プロ バテ ィ 
fontName フォ ント 名 を 取得 する 127 
fontType フォ ント が 埋め 込み か デバ イス フォ ント か 調べ る 127 
FrameLabel フ ラス 
ロ パ ティ 
frame name プ ロバ ティ で 示さ れる ラベ ル が 設定 され た フレ ー ム の 番号 219 
name ラベ ル と し て 設定 され た 文字 列 219 
Graphics フ ラス 
メソ ッ ド 
beginBitmapFl ビッ トマ ッ プ データ で 塗り つぶ す 329 
beginFill 描画 する 色 を 指定 する 329, 333 
beginGradientFil グラ デー ショ ン 塗 り を 指定 する 329, 339 
beginShaderFll シェ ー ダ 塗り を 指定 する 329 
clear 塗り と 線 の スタ イル を クリ ア す る 329 333 
curveTo 曲線 を 描画 する 330. 337 
drawCircle 円 を 描画 する 328 
drawEllipse 棒 円 を 描画 する 328 
drawRect 知 形 を 描画 する 329 
drawRoundRect 角 丸 の 息 形 を 描画 し ます 329 
endF 員 beginF 山 、beginGradientFil、beginBitmapFil メ ソ ッ ド に よっ て 333 
設定 され た 塗り を 描画 オブ ジェ クト に 適用 
lineGradientStyle 線 の グラ デー ショ ン を 指定 する 330. 340 
lineStyle 線 の スタ イル を 指定 する 330 334 
lineBitmapStyle ビッ トマ ッ プ を 使用 し て 線 を 描く 330 
lineTo 線 を 描画 する 330 337 
moveTo 描画 位置 を 指定 する 330 337 
IKArmature グ ラス 
プロ パテ ィ 
rootUoint ルー ト ジ ョ イ ント を 参照 249 
name アー マチ ュ ア の 名 前 249 
メソ ッ ド 
getBoneByName ボー ン を 名 前 で 取得 する 249 
registerElements ライ ブラ リシン ボル イン スタ ンス の IK 移 動 を アク ティ ブ 化 249 
IKBone グ ラス 
プロ パテ ィ 
headJoint ヘッ ドジ ョ イン ト / テ ー ル ジョ イン ト を 参照 253 
tailJoint 253 
name ボー ン の 名 前 253 
IKEvent フ ラス 
プロ パテ ィ 
distance ジョ イン ト の 元 の 位置 か ら の 距離 258 
iterationcount IK 移 動 実 行 の 繰り 返し 回 数 「 258 
joint イベ ント に 関連 し た ジョ イン ト 258 
time 前 回 の IK イ ベン ト か ら の 経過 時 間 258 
イベ ント 
distanceLimit IKMover.distanceLimit で 指定 され た 距離 を 超え た 場合 に 発生 258 
iterationLimit IKMover.iterationLimit で 指定 され た 繰り 返し 回 数 を 超え た 場合 に 発生 258 
singleStep IKMover の 反復 処理 の 各 ス テッ プ で 発生 258 
timeLimit IKMover.timeLimit で 指定 され た 距離 を 超え た 場合 に 発生 258 
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IKJoint ク ラス 





プロ パテ ィ 


bone 


name 

position 

rotation 
rotationContrained 
rotationEnabled 
rotationMax/rotationMin 
SDeed 
xTanslationyTranslation 


xTranslationconstrained/ 
yTranslationConstrained 


xTranslationEnabled/ 
yTranslationEnabled 


xTranslationMaX/ 
yTranslationMax 


メソ ッ ド 
isEnabled 
setConstrained 


setEnabled 





EE の ルン 
プロ パテ ィ 
numArmatures 


メソ ッ ド 
qetArmatureAt 
qetArmatureByName 
trackAlIArmatures 
trackIKArmature 
trackIKObject 


IKMover ク ラス 


ジョ イン ト が 関連 する ボー ン 

ジョ イン ト オ ブ ジェ クト の 名 前 
ジョ イン ト の 位置 する 現在 位置 座標 
回 転 の 現在 値 

回 転 を 制限 され て いる か 
回 転 が 有 効か 

回 転 の 最大 値 / 最 小 値 

回 転 速度 を 制限 

x 方 向 / 方 向 へ の 現在 の 移動 値 


x 方 向 ん 方向 へ の 移動 が 制限 され て いる か が 
x 方 向 / 方 向 へ の 移動 が 有効 か 


x 方 向 / 方 向 へ の 移動 最大 値 / 最 小 値 


ジョ イン ト の 動き が 制限 され て いる か 
ジョ イン ト の 動き を 制限 
ジョ イン ト の 動き を 有効 / 無 効 


存在 する アー マチ ュ ア 数 を 調べ る 


イン デック ス を 指定 し て アー マチ ュ ア オブ ジェ クト を 取得 する 
名 前 を 指定 し て アー マチ ュ ア オブ ジェ クト を 取得 する 
アー マチ ュ ア の ライ ブ ト ラッ キン グ を 有効 / 無 効 に する 


の 53 
253 
253 
253 
253 
253 
の 53 
253 
253 


253 


253 


253 


254 
254 
254 
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Z48 
248 
248 
248 
248 


プロ パテ ィ 


distanceLimit 
iterationLimit 
limitByDistance 
limitBylteration 
limitByTime 
timeLimit 
メソ ッ ド 
IKMover 


IK ジ ョ イン ト を 移動 で きる 最大 距離 を 制限 

1 回 の 移動 で の 最大 繰り 返し 回 数 を 制限 

distanceLimit 値 を 超え た 後 、IK エ ンジ ン が 移動 を 終了 する か どう か 
iterationLimit 値 を 超え た 後 、IK エ ンジ ン が 移動 を 終了 する か どう か 
指定 され た timeLimit を 超え た 後 、IK エ ンジ ン が 移動 を 終了 する か どう か 
移動 を 実行 する 最大 時 間 ミ リ 秒 単位 を 


254 
254 
254 
254 
の 54 
の 54 


254 


IKMover オ ブ ジ ェクト を IKJoint オ ブ ジ ェクト と 関連 付け る 


moveTo 


いり コク アル レア < 


IK ジ ョ イン ト を 移動 する 


の 54 





プロ パテ ィ 
conversionMode 


enabled 


IME 変 換 モ ー ド を 設定 / 取 得 
IME の オン オフ を 設定 / 取 得 


129 
129 


InteractiveObject ソ ラス 


プロ パテ ィ 


ダブ ルク リッ クイ ベン ト を 受け 取る / 受 け 取 ら な い を 指定 


doubleClickEnabled 


focusRect 


フォ ー カ ス 短 形 を 表示 する / し な い を 指定 


193 194 
193. 204 
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mouseEnabled マウ スイ ベン ト を 受け 取る / 受 け 取 ら な いか を 指定 193 194 
tabEnabled タブ 順序 に 含め る / 含 め な い を 指定 193 204 
tablndex タブ 移動 順 を 指定 193 204 
イベ ント 
click マウ ス の ボタ ン を 押し て 離し た と き 193 194 
mouseDown 193 194 
mouseUp 193 194 
doubleClick マウ ス の ボタ ン を ダブ ルク リッ ク し た と き 193 195 
mouseMove マウ ス を 移動 ご で せ た と き 193 195 
mouseOver マウ スカ ー ソ ル が オブ ジェ クト 内 に 入っ た と き / 出 た と き 193 195 
rollOver 193 195 
mouseOut 193 195 
rollOut 193 195 
mouseWheel マウ スホイ ー ル を 回 転 さ せ た と き 193 195 
mouseFocusChange マウ ス に より オブ ジェ クト が フォ ー カ ス を 取得 / 喪 失 し た と き 193 195 205 
focusIn オブ ジェ クト が フォ ー カ ス を 取得 し て ハイ ライ ト さ れる と き 205 
focusOut フォ ー カ ス を 喪失 し た と き 205 
keyFocusChange ユー ザ の キー ボー ド 操 作 に より 現在 の オブ ジェ クト が フォ ー カ ス を 失 お うと する と き 198 205 
keyDown オブ ジェ クト が フォ ー カ ス を 得 た 状態 で キー ボー ド が 押さ れる 198 
keyUp キー を 離す 198 
プロ パテ ィ 
capsLock capsLock キ ー が アク ティ ブ か 201 
numLock numLock キ ー が アク ティ ブ か 201 
プロ バ パティ 
altKey Alt キ ー が 押さ れ て いる か 198 
charCode どの キー が 押さ れ た か 198 
ctrlIKey Ctrl (Windows/Linux) /Command (Mac OS) キー が 押さ れ て いる か 198 
keyCode キー コー ド 値 198 
keyLocation キー ボー ド の キー の 場所 199 
shiftKey Shift キ ー が 押さ れ て いる か 199 
ロバ ティ 
content 読み 込ん だ ファ イル に アク セス する 225 294 
contentLoaderlnfo ファ イル の 読み 込み 状況 と 、 フ ァイル に 関す る 大 き さ な どの 情報 を 得る 225 294 
メソ ッ ド 
close 読み 込み 処理 を キャ ン セ ル す る 226 229 295 
load ファ イル 名 を 指定 し て 読み 込み を 開始 する 226 229 295 
Loader Loader オ ブ ジ ェクト を 作成 する 226 
unload 読み 込ま れ た オブ ジェ クト を 削除 する 226 229 295 
unloadAndStop 読み 込み まれ た SWF の 実行 を 中 止 し て 削除 する 226 229 295 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 ーー や oo 


ezte【llslto の な か ァ 4 
ロバ ティ 


bytesLoaded SWF フ ァイル の 読み 込み 済み バイ ト 数 を 表す 233 


bytesTotal SWF フ ァイル の トー タル バイ ト 数 を 表す 233 
bytesLoaded ロー ド 済 み サ イズ を 取得 する 298 
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INDEX 





bytesTotal ロー ド す る ファ イル の サイ ズ を 取得 する 299 
content 読み 込ま れ た オブ ジェ クト を 参照 する 299 
frameRate 読み 込ん だ SWF の フレ ー ム レー ト を 取得 する 299 
height 読み 込ま れ た ファ イル の 幅 と 高 さ を 取 得する 299 
width 299 
swfVersion 読み 込ん だ SWF の ファ イル 形式 バー ジョ ン を 取得 する 299 
イベ ント 
complete ファ イ ル の 読み 込み が 完了 し た と き に 、contentLoaderlnfo オ ブ ジ ェクト に 234 298 
よっ て 送出 され ます 
httpStatus HTTP ス テー タス コー ド を 検出 で きる と き 298 
Int 読み 込ま れ た SWF フ ァイル の プロ バテ ィ お よび メン ッ ド に 234 298 
アク セス で きる 場合 6 
ioError 入出 力 エ ラー に より 読み 込み が 失敗 し た と き 234 298 
open ロー ド を 開始 し た と き 298 


ほほ. ,: 油 間 還 間 間 間 昌 旨 間 間 昌和 
DrOdreSS 読み 込み 処理 を 実行 中 に デー タ を 受信 し た と き 233 298 














メソ ッ ド 

abs 絶対 値 65 
ceil 小数 点 切 り 上 げ 65 68 
floor 小数 点 切 り 下 げ 65 68 
max 最大 値 65 
min 最小 値 65 
POW 累乗 (べき) 66 
random ラン ダム な 数 66 67 
round 四捨五入 66 68 
sqrt 平方 根 66 








| x 軸 方 向 の 拡大 / 縮 小 、 回 転 の パラ メー タ を 設定 268 


d y 軸 方 向 の 拡大 / 縮 小 、 回 転 の パラ メー タ を 設定 268 
b x 軸 方 向 の 回 転 、 傾 斜 の バラ メー タ を 設定 268 
y 軸 方 向 の 回 転 、 傾 終 の バラ メー タ を 設定 268 
tx x 軸 方 向 の 移動 距離 を 設定 268 
ty y 軸 方 向 の 移動 距離 を 設定 ! 268 
メソ ッ ド “ 
clone オブ ジェ クト の コピ ビー を 作成 する 269 
createBox 回 転 、 拡 大 / 縮 小 、 平 行 移動 の 変換 を まとめ て 設定 する 269 
createGradientBox 適用 する グラ デー ショ ンス タイ ル を 作成 する 269 
rotate 回 転 変換 を 適用 する 269 
scale 拡大 / 編 小 変換 を 適用 する 269 
translate 平行 移動 を 適用 する 269 270 


hs 
transformPoint 現在 の マト リッ クス を ある Point オ ブ ジ ェクト に 適用 し た 結果 を 得る 269 









position 対象 オブ ジェ クト の 3D 座 標 を 調べ る 276 
メソ ッ ド | 

append 別に 作成 し た Matrix3D オ ブ ジ ェクト を 追加 する 276 287 
prepend 276 287 
appendRotation x/y/z 軸 で の 回 転 を 加え る 276 287 


prependRotation 


apDpendScale 


DrependScale 


appendTranslation 


prependTranslation 


clone 


InVert 


に (0 
tegguitii: の ルン 
プロ パテ 「 


INDEX 


276 287 
x/y/z 軸 方 向 に 拡大 / 縮 小 を 行う 276 287 
276 287 
x/y/z 軸 方 向 の 位置 を 移動 する 276 287 
276 287 
Matrix3D オ ブ ジ ェクト の クロ ー ン コピ ー を 作成 する 276 287 


逆 の 変換 を 行う 反転 行列 を 作成 する 276 287 


ロバ ティ 

activityLevel 現在 の サウ ンド 量 を 調べ る 359 
codec コー デック 名 を 取得 / 設 定 する 359 
gain 入力 ゲイ ン を 取得 / 変 更 する 359 
muted ユー ザ の マイ クア クセ ス 許 可 を 調べ る 359 
name 現在 の サウ ンド キャ プチ ャ デバ イス の 名 前 を 取得 する 359 
names 使用 可能 な すべ て の サウ ンド 入力 デバ イス の 名 前 の 配列 を 取得 する 359 
rate 入力 オー ディ オ の サン ブル レー ト を 取得 変更 する 359 
silenceLevel マイ ク を 有効 に する た め に 必要 な サウ ンド 量 を 指定 する 359 
silenceTimeout マイ ク が 無音 状態 で ある と 判断 され る まで の 時 間 を 指定 する 360 
メソ ッ ド 

getMicrophone Microphone オ ブ ジ ェクト を 取得 する 360 
setLoopBack ロー カル スピ ー カ ー に 音声 を 出力 する 360 
setSilenceLevel サウ ンド と 見 な す 最 小 入 力 レ ベル を 設定 する 360 
setUseEchoSuppression オー ディ オフ ィ ー ド バッ ク が 発生 する リス ク は 軽減 360 
イベ ント 

activity セッ ショ ン の 開始 / 終 了 360 
status マイ クス テー エエ II ユ I=5=5 和 KKIIK>KW べ 4 べべ 


プロ パテ ィ 


237. 240 244 


duration モー ショ ン の 継続 時 間 

is3D 3D プ ロバ ティ を 持つ モー ショ ン を 作成 
メソ ッ ド 

addFilterPropertyArray 

addKeyframe キー フレ ー ム を 追加 
addPropertyArray モー ショ ン に プロ パテ ィ の 変更 を 追加 


getCurrentKeyframe アク ティ ブ な キー フレ ー ム を 取得 
getValue ある フレ ー ム の トゥ イー ンプ ロ パ ティ 値 を 取得 
initFilters モー ショ ン に フィ ルター を 追加 


Me に = スリ /-) 1 の ムッ 4 
プロ パテ ィ 





altKey Alt キ ー が 押さ れ て いる か 

buttonDown マウ ス の 主 ポ タン が 押さ れ て いる か 

ctrIKey Ctrl キー が 押さ れ て いる か (Windows/Linux) 
delta マウ スホイ ー ル の 1 目盛 り じ で スク ロー ル す る 行 数 
localX マウ スイ ベン ト の 発生 位置 (ロー カル 座標 ) 
localY 

shiftKey Shift キ ー が 押さ れ て いる か 

stageX マウ スイ ベン ト の 発生 位置 (グロ ー バ ル 座 標 ) 


stageY 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー す To 
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otohththththththththththt よ ね や や べべ つべ べべ つつ 244 


195 
195 
195 
195 
195 
195 
195 
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oto ウル ン ア < パ 
プロ パテ ィ ( 





currentFrame 再生 ヘッ ド が ある フレ ー ム の 情報 を 得る 214 219 
currentFrameLabel 214 219 
currentLabel 214 219 
currentScene 現在 の シー ン を 得る 214 219 
currentLabels 現在 の シー ン に ある ラベ ル を 得る 214 219 
enabled ボタ ンタ イプ の ムー ビー クリ ッ プ を 有効 無効 に する 214 
framesLoaded 読み 込み 済み フレ ー ム 数 を 取得 する 214 
loaderlnfo LoaderInfo オ ブ ジ ェクト に アク セス する 214 
SCenes ムー ビー クリ ッ プ 内 の すべ て の シー ン を 取得 する 214 219 
totalFrames ムー ビー クリ ッ プ 内 の フレ ー ム 数 を 取得 する 214 219 
メソ ッ ド 

gotoAndPlay 指定 フレ ー ム か ら 再 生 を 開始 する 215 217 
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一 著者 プロ フィ ー ル 

宮田 況 (みや た りょう ) 

20 年 を 超え る IT 開発 ・ 教 育 ・ マ ネー ジメント キャ リア を 持つ 。 新 卒 で 入社 し た 通信 メー カー 系 の シス テ 
ム 開 発 部 に 従事 し 、 バ ケッ ト 交 換 機 の 基礎 開発 を 行う 。1990 年 代 に 独立 し 、 そ の 後 シ ステ ム 開 発 と IT 技 
術 教 育 を 主 に 行う 。 基 幹 業務 、 営 業 支援 、Web デ ー タ ベー ス 、EC サ イト 、 デ ー タ マイ ニン グ ( ビ ジネス 
イン テリ ジェ ンス ) を は じ め と する 大 小数 多く の 開発 プロ ジェ クト に 関わ る 。 Java、C/C++、Oracle、 
MySQL、.NET な ど に よる シス テム 設計 開発 を 長年 行い 、Linux 系 サー バ 構 築 と メン テ ナ ン ス も 合わ せ て 
行う 。 近 年 Flash に よる RIA を 発端 と し て 、Flex、AIR に よる 開発 、 著 作 、 セ ミナ ー 提 供 な ど を 行う 。 技 
術 者 養成 の 専門 スク タール IT 塾 (Adobe 認定 トレ ー ニ ング セン ター) 校長 と し て Flex/AIR セ ミナ ー や IT 技 
術 講 斬 も 随時 開講 し て いる 。 アド ビ Creative Suite Video Tutorial の ロー カリ ゼー ショ ン 、Flex 4/AIR 
2 プレ リリ ー ス プロ グラ ムコ ミュ ニテ ィ マ ネー ジャ 、Flex/AIR ハ ンズ オン セミ ナー な ど 、 ア ド ビ と の コラ 
ポレ ーション を 多く 行っ て いる 。 


仁 Web シ ステ ム 開 発 株 式 会 社 代表 
http://WWww.websysd.com/ 


また 、I 技 術 者 の スキ ル ア ッ プ を 行う IT 塾 を 運営 。 
Flash、AIR、Flex、Java そ の 他 筆 者 が 直接 マン ツー マン 教育 を 行う こと も ある 。 


人 で IT 妥 
Adobe 説 定 ト レー ニン グセ ンタ ー /CompTIA ト レー ニン グセ ンタ ー 
http://www.it-school.org/ 


筐 取得 資格 
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・Adobe Flex デ ベロ ッ パ ー 
・Adobe Flash デ ベロ ッ パ ー 
・ Adobe Dreamweaver デ ベロ ッ パ ー 
・Sun 認 定 Java ディ イ ベ ロッパ 
・Sun 認 定 Web コン ポー ネン トディ ベロ ッ パ 
・Sun 認 定 Solaris シ ステ ム 管 理 者 for Solaris 10 
ほか 
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本 書 を お 読み いた だ いた ご 感想 、 ご 意見 を 上 記 URL か ら お 寄せ くだ さい 


還 注意 事項 

〇 本 書 内 の 内 容 の 実行 に つい て は 、 す べ て 自己 責任 の も と で $ こ な っ て くだ さい 。 内 容 の 実行 に より 発 
生 し た いか な る 直接 、 間 接 的 被害 に つい て 、 筆 者 お よび ソフ トバ ンク クリ エイ ティ ブ 株 式 会 社 、 製 品 
メー カー、 購 入 し た 書店 、 シ ョ ッ プ は その 責 を 負い ませ ん 。 

〇 本 書 の 内 容 に 関す る お 問い 合わ せな ど は 、 ご 面倒 で も 小 社 テ クニ カル 書籍 編集 部 まで 、 必 ず 書 面 に て 
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だ さい 


また 、 本 書 の 内 容 以外 に つい て の ご 質問 に つい て は 、 お 答え し か ね ます の で ご 了承 くだ さい 。 
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